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This manual describes the Free Programmable Module (FPM). The FPM, which is contained on 
the submodule PU535, extends the application programmability of the Advant Controller 400 
series. When you are implementing an application containing time-consuming and advanced 
algorithms in an Advant Controller, it is beneficial to use FPM. Algorithms which are developed 
using FPM and stored on the PU535 submodule are also hidden so they cannot be copied by 
unauthorized personnel. 


FPM extends the ABB Master Programming Language (AMPL), allowing advanced algorithms 
which are written in the programming language C (FPM application) to be stored and executed 
on the PU535 submodule. To supervise the execution of the FPM application containing the 
aforementioned algorithms, the AMPL element FPM-COM is used. The AMPL elements 
FPM-I, FPM-O, FPM-IA and FPM-OA are used to exchange data between the application 
implemented in the Advant Controller and the FPM application stored on the submodule 
PUS35. 


The equipment necessary to implement the two programs you need when using FPM is 
described below and in Figure 1-1. 


° An HP 9000/700 series workstation is used when developing and installing the FPM 
application containing an advanced algorithm, etc., on PUS35. 


° The Advant Station 100 Series Engineering Station (AS 100 ES) is used when developing 
the AMPL program supervising and exchanging data with the FPM application. 


To use this manual, you should be familiar with the basic concepts of the ABB Process 
Automation system. This manual is intended primarily for personnel using FPM to implement 
application programs in an Advant Controller. Personnel implementing an application using 
FPM must have experience in C programming as well as in AMPL programming. 
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Figure 1-1. FPM Development Environment 
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1.2 Equipment Requirements 


1.2.1 Target System 
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Hardware in the AC 410 
° PU535 submodule, equipped with 512 KB RAM and 512 KB Flash PROM. 
° CI536 submodule, equipped with 1 MB RAM and | MB Flash PROM. 


The submodule is connected to one of the four submodule positions on the main processor 
module PM150. 


Hardware in the AC 450 

° PU535 submodule, equipped with 512 KB RAM and 512 KB Flash PROM. 
° CI536 submodule, equipped with 1 MB RAM and | MB Flash PROM. 

° A free submodule position on one of the following submodule carriers: 


— $C510 Carrier without local processor (one submodule position can also be used for 
other functions, i.e. MB 300). 


— $C520 Carrier with local processor for MB 300 (one submodule position can also be 
used for other functions, i.e. MB 300). 


— $C530 Carrier with local processor for GCOM (one submodule position can also be 
used for GCOM). 
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1.2.2 Development System 


Work Station 
° HP 9000/700 work station with one free RS232-C serial communication port. 


° DAT driver for installation of software. 


Software 

° SDE (optional) 

° HP-UX 9.0 or later 
° FPMBase *1.0 


PROM Programmer 
° A PROM programmer which supports programming of 28F020 type Flash PROMs. 


Engineering tools 
To build the database and the PC program in the AC 400, you need an: 


° Advant Station 500 Series Engineering Station or an Advant Station 100 Series 
Engineering Station. 


3BSE 001 688R0001 Rev A 


1.3 Manual Organization 


Figure 1-2 shows the basic structure of the Advant System’s documentation. Each document, 
describing either hardware or software, is built around this structure to make it easy to locate 
related information in any of the documents. 
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Figure 1-2. Basic structure Advant System documentation 
Introduction 
Chapter | serves as an introduction to the FPM Development Environment. 
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1.4 Conventions 
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Installation 


This chapter describes how to configure the Advant Controller so it can act as a host system for 
FPM contained on the PU535 submodule. It also provides step-by-step instructions on how to 
install the software needed. Start-up and shut-down procedures and how to verify correct 
operation after power up are also described. 


Configuration and Application Building 


This chapter tells you how to use the Free Programmable Module (FPM). To use FPM, both an 
AMPL program in the host system and an FPM application, linked together with the Host 
Interface contained on PU535, must be constructed. The main purpose of the chapter is to 
provide a step-by-step description of how to build these two types of applications. 


Runtime Operation 


This chapter provides information on how to operate FPM. It also describes how to test, on-line, 
the developed FPM application, written in C, installed on PU535. 


Maintenance 


This chapter describes how to maintain the PU535 submodule containing FPM. It also describes 
how to do fault tracing in different error situations. 


All input values to database elements which require you to enter the value are boldfaced. 


All commands described, which are given on the command line in the Development System or 
in the target system, are boldfaced. 


All references are in italics. 


All program code examples are presented in the font shown below: 
main () 

{ 

/* This is a sample program */ 

printf (“Hello world!”); 

} 


$ Prompt in Korn shell (HP-UX command interpreter). 
-> Prompt in VxWorks shell. 
(vxgdb) Prompt in VxGDB command interpreter. 
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1.5 Related Documentation 


For further information about configuration and application programming, refer to the following 
documents. 


ABB Master ABB Master HP 
Advant Controller System Documentation 
400 Series 
| 
Free Programmable Module Installation Rules Creating Product 
AC 400 User’s Guide Packages for HP-UX 
Order no. B2355 900031 
Configuration and HP9000 Networking, 
Programming AC 400 Using Serial Line IP 
Protocols 


Order no. 88194-80583 
Data Base Elements 
AC 400 


PC Elements AC 400 


AC 410 User’s Guide 


AC 450 User’s Guide 


Figure 1-3. FPM and Related Documentation Tree 
1.6 Release History 


1.0 - Initial release of the Free Programmable Module (FPM) for the Advant Controller 410 
and 450 series. 
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1.7 Terminology 
° AC is an abbreviation for Advant Controller 
° AC 400 is an abbreviation for the ABB Master Advant Controller 400 Series 
° AMPL is an abbreviation for the ABB MasterPiece Language 


¢ AMPL application is an application written in ABB MasterPiece Language and used to 
supervise the FPM application 


* AS 100 ES is an abbreviation for Advant Station 100 Series Engineering Station 
° DPM (Double Port Memory) is the interface between the Host system and PU5S35 
° FPM is an abbreviation for Free Programmable Module 


° FPM application is a module, written in the programming language C and installed on 
PUS535, interacting with an AMPL program to perform calculations, etc. 


° PC program (Process Control program) is a program written in AMPL 


° SDE (Software Development Environment) is an environment for project management 
developed by ABB 


° SLIP (Serial Line Internet Protocol) is the communication protocol used between the 
Development System and the PUS35 submodule 


° Spawn: to spawn a task means to start the execution of the task 


° Task is an instance of a program in execution. 
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1.8 Product Overview 
The Free Programmable Module (FPM) consists of the following base components. 
° FPMLib 
— Read and write routines for different data types. 
° Executive 
— Initializes timers, pipes and structures used by FPM application. 
— Copies information from dual port memory (DPM) to FPM application. 
— Copies information to dual port memory (DPM) from FPM application. 


— Executes the FPM application installed on PU535 with a cyclicity fetched from the 
host system, which is the cyclicity of the AMPL control module supervising the 
application module. 


— Checks that the runtime of the FPM application does not exceed the cyclicity of the 
control module of the AMPL program supervising the application module. 


° User Test Interface 


— Interface to User Test Environment, used for control and diagnostics of developed 
FPM application. 


A schematic figure of the FPM Development Environment follows. 
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Figure 1-4. FPM Environment 
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Development System 
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° AS 100 ES is used when developing the AMPL program supervising the FPM application. 


° SDE installed on HP-UX 9000/700 series workstation is used when implementing the 
FPM application module to be installed on PU535. 


° A VT100 emulator, installed on an HP-UX 9000/700 series work station, or a VT100 
console terminal is used when working with the User Test Interface. 


Target System 


° AS 100 ES is used when interacting with the AMPL program supervising and exchanging 
data with the FPM application. 
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Chapter 2 Installation 


2.1 Site Planning Environment 


You find guide lines for earth connection, power supply etc. in the manual ABB Master 
Installation rules. 


The following requirements apply for the Development system: 

° HP 9000/700 with HP-UX version 9.0 or later. 

° SDE installed (optional). 

The following requirements apply for the Advant Controller system: 

° AC 410, with a PU535 submodule or, 

° AC 450, with an SC510, SC520 or SC530 carrier and a PU535 submodule. 


2.2 Setup 


2.2.1 Hardware 


No hardware is included in FPM. However the following hardware must be available for the 
development: 


° Advant Controller 410, or 

° Advant Controller 450, with an SC510, SC520 or SC530 carrier. 

° PU535 submodule for the final FPM application. 

° CI536 submodule for development and debugging purposes. 

° HP 9000/700 series workstation with one free serial port. 

° A PROM Programmer capable of programming 28F020 type FlashProms. 


The PU535 submodule is equipped with two independent, CCITT V.24 (RS232-C), 
asynchronous communication ports, see Figure 2-1. 


° In Advant Controller 410 the PU535 submodule is connected to one of the four submodule 
positions on the main processor module PM150, 


° In Advant Controller 450 the PU535 submodule is connected to a free submodule position 
on one of the following submodule carriers: SC510, SC520 or SC530. Figure 2-1 shows 
two PU535 submodules connected to a SC510 carrier. 


3BSE 001 688R0001 Rev A 2-1 


Free-Programmable Module 
Chapter 2 Installation 


hae F= FAULT LED 
has PORT 1 ae 
PU535 PU535 
-— SUBMODULE 1 SUBMODULE 
PORT2 — 


PU535 
| SUBMODULE 2 


Figure 2-1. SC510 carrier and PU535 submodules 


There are no strappings on the PU535 submodule and no strappings on the carrier boards 
SC510, SC520 and SC530. As shown in the figure above there are two ports on the PU535 
submodule. When the PU535 submodule contains PROMs with software needed for FPM, port 
1 is used for console communication and port 2 is used for connection of an HP 9000/700 series 
work station using the SLIP protocol. To setup the PU535 submodule, the database element 
PUS535 is used, see Section A.1 Database Element and Figure 2-2. 


3BSE 001 688R0001 Rev A 


3BSE 001 688R0001 Rev A 


FPM1 


Free-Programmable Module 
Section 2.2.1 Hardware 


Free prog. module 


(340.1 ) 
— 1 — NAME WARNING |— 16— 
— 3 —/ BUS ERR | — 17— 
— 4 — STATION ERRTYPE }— 9 — 


—— 5 — POSITION 


—— 6 —) SUBPOS 
—— 10 —y IMPL 
— PUS35 —| TYPE 


Figure 2-2. Database element PU535 


You must check or fill in correct values on the PU535 database element (Element type is FPM 
and Call name is PU535). For further description, please refer to the Data Base Elements 
AC 400 User's Guide. Figure 2-3 and Figure 2-4 shows how to fill in the values of position and 


subposition in AC 410 and AC 450. 
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Figure 2-3. Position and subposition for PU535 submodule in AC 410 
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Figure 2-4. Position and subposition for PU535 submodule in AC 450 
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Cable used for SLIP Communication 


The Cable for SLIP communication has a nine-position D_Sub Connector Receptacle (female) 
for connection to one port on the HP 9000/700 work station and a nine-position D-Sub 
Connector Receptacle (female) for connection to one port on the front of the PU535 
submodule. The connection between the nine-pin connectors is shown in the table below 


Table 2-1. Description of Connections According to CCITT V.24 


No. in Nine- | No. in Nine- Direction 
Description Signal Pin Pin CCITT V.24 IN <—_ 
Connector 1 | Connector 2 ——t OUT 

Data Carrier Detect DCD 1 1 109 a 
Receive/Transmit RD/TD 2 3 104 <= —_ 

Data(”) — 

Transmit/Receive TD/RD 3 2 103 — 
Data 5, 

Data Terminal Ready DTR 4 4 108/2 = 
Signal Ground SG 5 5 102 ——— 
Data Set Ready DSR 6 6 107 pa =< 

Request To Send RTS 7 7 105 ——_ 
Clear To Send CTS 8 8 106 <= 
Ring Indicator RI 9 9 125 _—— 


(1).Note that Receive Data and Transmit Data are crossed. 


2.2.2 Software 
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Make sure that the following requirements are fulfilled in the Development system: 
° HP 9000/700 with HP-UX version 9.0 or later 
° FPMBase installed 


The software needed for the development of an FPM application is stored in a directory tree. 
The directory structure on the next page applies for the FPM development environment. 
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ipa products FPMBase 1.0-0 bin 
doc 
etc *) 
|_| forms *) 
help *) 
include 
info *) 
lib 
load *) 
source 
User Development Structure 
projects App A ee members [{“developer” eta ont work + Application” 
|_| FPMUser 
Test 
—| Integration 
HAD ple ion members H{‘developer” Apptivatiin work Application 
|_| FPMDemo 
Test 
Integration 


*) Not used in current version. 


Figure 2-5. FPM Development Environment 
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Installation of SDE includes loading the software and setting up the configuration files. The 
installation procedures are described in the SDE Installation Guide found in the SDE product 
binder. 


Installation of PPL (SLIP interface) includes loading the software. PPL software is supplied on 
the LAN/9000 installation tape. It is part of the SLIP-RUN fileset. If you are loading the entire 
networking partition, this fileset is loaded automatically. The installation procedures are 
described in HP 9000 Networking, Installing and Administering LAN/9000 Software. 


2.3 Shut-down Procedures 


Use normal logout procedure, that is, give the command /ogout at the command shell prompt, to 
shut down the communication between the development system and the target system. 


The User Test Interface is stopped by pushing the key <q> on the User Test Interface menu. 


The FPM application is stopped by applying | to the terminal STOP on the FPM-COM element, 
see Section A.2 PC Elements. 


2.4 Start-up Procedures 
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Use normal login procedure, that is, give the command rlogin <target> at the HP-UX command 
shell prompt, to start the communication between the development system and the target 
system. 


The User Test Interface is started by giving the command <fpmUTIMain> 
The PU535 submodule always restarts if the AC 400 is restarted in any way. 


Check all the system messages when you restart the PU535 submodule. All configuration errors 
are reported at start-up. Error messages with task name tFPMxxx sent from the FPM 
Environment are translated in Section 5.3 Error Messages. Note that some errors are only 
reported once. 
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2.5 Product Verification 


When the PU535 submodule is correctly installed, the corresponding PU535 database element 
is filled in and the PC program supervising the FPM application is not in build mode, the 
following should be indicated: 


° The green LED indicator on the front of the PU535 submodule is lit. 
° Database element PU535 Terminals ERR and ERRTYPE = 0. 
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3.1 Design Considerations 
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The Free Programmable module PU535 has no direct I/O connections of its own. Thus all input 
data is provided, by the AMPL-module in the Advant Controller. All output data from FPM, 
contained on PU535, is read by the mentioned AMPL module via the dual port memory. The 
total amount of exchanged data can be separated into three groups. 


° Control data. It influences the execution of the FPM application module and is sent from 
the host system. 


° Status data. It supplies information about the current status of FPM and is sent from FPM 
to the host system. 


° Processing data. It serves as input and output data for the FPM application, written in the 
programming language C and installed on the PU535 submodule. 


It is often necessary to make sure that all data transferred between the AMPL-program and FPM 
is consistent. This means that both the AMPL-module and the FPM application, installed on 
PUS535, will only get input data produced during the same processing cycle of the AMPL- 
module. 


NOTE 


Data transferred by one PC-element (FPM-O, FPM-I, FPM-OA, FPM-IA) will 
always be consistent. 


To secure consistent data transfer, the two following restrictions must be considered: 
1) Data Transfer from AMPL-program to PU535 


For consistent data transfer in this direction, the exact starting point of the FPM 
application is important. Only if start of the FPM application is out of the AMPL module 
runtime for writing data to the double port memory, consistency will be guaranteed. 

To ensure that the FPM application will not start until the dual port memory is updated 
with consistent data, the RUN or CONTINUE command must be given at the end of the 
AMPL-module. That is, the FPM-COM element transferring these commands must be 
located after the last FPM-O or FPM-OA element in the control module, containing the 
AMPL module supervising the FPM application. 


2) Data transfer from PU535 to AMPL Program 


Consistent Data Transfer in this direction can only be ensured, if the cycle time (TSC) of 
the control module containing the AMPL module is longer than the cycle time (TAC) of 
the FPM application and the processing time (TRN) of the AMPL program together. 


TSC > (TAC + TRN) 


Consistency of data will otherwise be reduced to block level, that is all the data in one 
block, 20 numerics or one string, will always be transferred consistently. 
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NOTE 


Data consistency may be lost if the FPM application is started from the menu of 
the User Test Interface (see Section 4.5 Runtime Operation Menus). When ending 
a target session, using the User Test Interface Menu, a STOP command is always 
issued implicitly. To start the FPM application after leaving the User Test 
Interface Menu, a RUN command has to be given, from the AMPL-module 
supervising the FPM application installed on the PU535 submodule. 


3.2 Capacity and Performance 


Maximum amount of data that can be sent between the FPM application and the 
corresponding AMPL module: 


° 1000 (50 blocks * 4 sections * 5 elements) numerical values or 
° 50 strings of at most 80 characters each or 


° a mix of numerical values and strings within the limits mentioned above 


Minimum cyclicity required to execute the demo-application (see Section 3.5 Tutorial): 
The demo-application included in the tutorial test (see Section 3.5 Tutorial) can be executed at a 
cyclicity of no less than 10 milliseconds. 


3.3 FPM Development Environment Setup 


The setup of the FPM environment differs depending on whether the system is to be used for 
development of a FPM application or if the system is a delivery system where the FPM 
application is stored in PROM. 


To be able to operate the FPM Development Environment, a number of setup parameters and 
files must be modified or created as described below. 


3.3.1 SDE 


If SDE is used, the project must be set up in SDE, that is, the project must be created, a system 
and possibly one or several subsystems must be created. For details, please refer to the SDE 
product binder. 


3.3.2 FPMBase 


VxWorks development tools must be configured by definition of certain environment variables, 
that is, MANPATH, VX_CPU_FAMILY and GCC_EXEC_PREFIX. Please refer to GNU 
Toolkit User’s Guide. The path to the VxWorks development tools must be added to the PATH 
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environment variable. Definition of these variables is preferably done in .kshrc (korn shell start- 
up file) in the developer’s login directory. 


# Environment script for Korn Shell. 
# This script is executed for each new Korn Shell. 


# Set up the path to development tools 
PATH=$PATH:/ipa/products/FPMBase/1.0-0/bin 
export PATH 

# Set up path to manual pages 
MANPATH=$MANPATH:/ipa/FPMBase/doc 
export MANPATH 

#Define variables for GNU tools 
VX_CPU_FAMILY=68k 

export VX_CPU_FAMILY 
GCC_EXEC_PREFIX=/ipa/products/FPMBase/1.0-0/bin 
export GCC_EXEC_PREFIX 


Figure 3-1. A sample .kshrc file 


3.3.3 Host/Target Internet Addresses 


The Internet addresses used for host and target must be legal addresses, that is, addresses owned 
by the corporation or organization that uses them. Using an illegal Internet address may cause 
the owner of the address to loose data packages. 


See your company’s policy regarding the use of Internet addresses. Your work station system 
administrator should be able to help you. 


3.3.3.1 Configuring the Host System 


Before the point-to-point SLIP network can be used, the network software on the host node 
must be correctly configured. There are three main tasks in configuring the host network 
software: 


° Initializing the host network software. 
° Establishing the target system name and network address on the host. 


° Giving the target system appropriate access permissions on the host. 


Initializing the Host Network Software 


The host system (HP9000/700 work station) automatically initialize the network subsystem and 
activate network processes. This typically includes configuring the network interface and 
starting various network daemons. In addition to this, the SLIP interface has to be configured 
and initialized. This is described in Section 3.3.4 SLIP Interface. 


3BSE 001 688R0001 Rev A 3-3 


Free-Programmable Module 


Chapter 3 Configuration/Application Building 


3-4 


Establishing the Target System Name and Address: /etc/hosts 


The host system maintains a database of the names and network addresses of the systems 
accessible from the local system. This database is kept in the ASCII file /etc/hosts which 
contains a line for each system. Each line consists of an Internet address and the name(s) of the 
system at that address. This file must have entries for your host system and the target system. 


For example, suppose your host system is called slip_host and has been assigned Internet 
address 138.221.124.9, and your target system is called slip_target and has been assigned 
Internet address 138.221.124.6. The file /etc/hosts should then contain the following lines: 


138.221.124.9 slip_host 
138.221.124.6 slip_target 


NOTE 


If your host system is running the Network Information Service (NIS) and/or 
Domain Name Services, then the “hosts database” is maintained by the Network 
Information Service facilities or the Domain Name Services facilities that are 
beyond the scope of this document. Consult your system administrator if you are 
running the Network Information Service and/or Domain Name Services. 


Giving the Target System Access to the Host: .rhosts and /etc/hosts.equiv 


The host system restricts network access via remote login, remote command execution and 
remote file access. This is done with the .rhosts file in the users home directory, and more 
globally with the /etc/hosts.eqiv file. The -rhosts file contains a list of systems that have access 
to your login. Thus, in our example above, to allow the target system to log in with your user 
name and access files with your permissions, you would create a .rhosts file in your home 
directory, containing the line: 


slip_target 


The file /etc/hosts.eqiv provides a less selective mechanism. System listed in this file are 
allowed login access to any user defined in the local system (except the super-user root). 
Thus, adding the target system name to /etc/hosts.equiv will allow the target system to log in 
with any user name on the local system. 


When inetd (Internet super-server, which invokes Internet server processes as needed) accepts a 
connection from a remote system, it checks the address of the remote host requesting the service 
against the list of remote hosts to be allowed or denied access to the specific service. The file 
inetd.sec allows the system administrator to control which hosts (or networks in general) are 
allowed to use the system remotely. This file constitutes an extra layer of security in addition to 
the normal checks done by the services. It precedes the security of the servers; that is, a server is 
not started by the Internet daemon unless the host requesting the service is a valid host 
according to inetd.sec. 


If file /usr/adm/inetd.sec, does not exist, security is limited to that implemented by the servers. 
Changes to inetd.sec apply to any subsequent connections. 


The lines in the file contain a service name, permission field, and the Internet addresses or 
official names of the hosts and networks allowed to use that service in the local host. 
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The fields in each line are as follows: 


<service name> <allow|deny> <host or net addresses, host or net names> 


where: 


service name is the name (not alias) of a valid service in file /etc/services. The service 
name for RPC-based services (NFS) is the name (not alias) of a valid service in file 
/etc/rpc. A service name in /etc/rpc corresponds to a unique RPC program number. 


allow|deny determines whether the list of remote hosts in the next field is allowed or 
denied access to the specified service. Multiple allow|deny lines for each service is 
unsupported. If there are multiple allow|deny lines for a particular service, all but the last 
line are ignored 


Addresses and names are separated by white space. Any mix of addresses and names is 
allowed. To continue a line, terminate it with \. 


Thus, in our example above, to allow the target system to access the host system using the 
services shell (remote shell), login (remote login) and rexd (remote procedure calls) you would 
add the following lines to the file /usr/adm/inetd.sec: 


shell allow  Xxx.xXxx.xxx _ slip_target 
login allow XxXx.xxx.xxx _ slip_target 
rexd allow  XXxX.Xxx.xxx _ slip_target 


NOTE 


These services might already be defined for different remote nodes or subnets. 
In that case, add the name of the target system (slip_target) to the lines. 


3.3.3.2 Configuring the Target System 


The host system and target system internet addresses must also be configured in the target 
system. This is done by editing the file inet.c, prior to generating a VxBase system. The file 
inet.c is described in Section 3.3.8 Preparation for System Building. 


3.3.4 SLIP Interface 


Configuration of PPL consists in setting up necessary support files. These procedures requires 
super-user privileges: 


The serial port on the HP 9000/700 work station, used for SLIP, requires a device file 
entry. The following example shows how to create a device file using mknod: 
$ mknod /dev/tty00 c 1 0x204004! 


Ensure that you have a /dev/ni device file. The PPL program uses this device to pass 
packets between the serial line and IP layer. If it is not present, create the device file using 
the following command: 

$ mknod /dev/ni c 56 0 


1. 
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The minor number value depends on a number of details concerning your HP9000/700 work station. See your 
HP9000/700 system administrator for details. 
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PPL must be configured and initialized to use the SLIP protocol, the internet address for the 
target system and the serial port available on the HP 9000/700 work station. PPL configuration 
involves creation of three files: 


° /usr/lib/ppl/ppl.users 
° /usr/lib/ppl/ppl.ipool 
° /usr/lib/ppl/ppl.remotes 


For direct connection, which is the only configuration used in the FPM Development 
Environment, ppl.remotes is the only file required and is the only file described here. The 
ppl.remotes file is a simple ASCII file that the super-user owns (creates). For the ppl.remotes 
file a template exists in the /usr/lib/ppl directory. 


The ppl.remotes file is the central database used by the PPL program. The file contains an entry 
for each remote host to which PPL can establish a connection. Each entry consists of a multi- 
line form. Depending on the type of connection you are permitting, that is direct, dial-in, dial- 
out, or both dial-in and dial-out, you enter different data. However, the format of the form is the 
same for all types, see Figure 3-2. 


# your comments here 1) 
slip_target # remote hostname or Internet address 2) 
slip_host # local hostname or Internet address 3) 
255.255.255.0 # Internet mask 4) 
SLIP # protocol SLIP, ASLIPC, ASLIPS, PPP 5) 
DIRECT # type DIRECT,DIALIN, DIALOUT, DIALIN & DIALOUT 6) 

# UUCP system name 7) 
NONE # line parity EVEN, ODD, NONE 8) 
19200 # line speed 9) 
/dev/ttyO0 # serial line 10) 

# phone number 1618) 
NO # modem control available YES, NO 12) 

# log in info 13) 

# command name 14) 


Figure 3-2. ppl.remotes form format 


The following is a description of each data field the ppl.remotes form: 


1. The first line is a comment line, describing the entry. If necessary, use additional lines for 
comments. Begin each line with a ‘“#’. 


2. This field identifies the remote host. It may specify a host name or alias, provided the 
name or alias can be resolved to an Internet address (by /etc/hosts, the Yellow Pages or 
domain name server). It may also be the Internet address in dot notation. This field is 
required. 
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This field identifies the local host. It may specify a host name or alias, provided the name 
or alias can be resolved to an Internet address (by /etc/hosts, the Yellow Pages or domain 
name server). It may also be the Internet address in dot notation. This field is required. 


This field specifies a mask which may be used to set up an IP subnet. If left blank, the 
mask is derived from the local Internet address. 


This field specifies the protocol to be used for connection. Available protocols are Serial 
Line Internet Protocol (SLIP), Abbreviated Serial Line Internet Protocol Client (ASLIPC), 
Abbreviated Serial Line Internet Protocol Server(ASLIPS), or Point-to-Point Protocol 
(PPP). Of these protocols, only SLIP is used by the FPM Development Environment. This 
field is required 


This field specifies the connection type. Only direct connection is used by the FPM 
Development Environment. This field is required. 


This field specifies the UUCP system name. It is not used by the FPM Development 
Environment. 


This field specifies line parity used for dial-up connections. It is not used by the FPM 
Development Environment. 


This field specifies the line speed (baud rate) to be used over the connection. The 
supported baud rate is limited by the system hardware. This field is required. 


This field specifies the device file to be used for the connection. This field is required. 


Here the phone number for the remote host is specified. This field is not used by the FPM 
Development Environment. 


This field controls the use of the modem signals during and after the connect phase of PPL. 
This field is required and must be set to NO. 


This field supplies the dialogue needed to login to the host. This field is not used by the 
FPM Development Environment. 


This field supplies the dialogue needed to invoke SLIP on the connected host. This field is 
not used by the FPM Development Environment. 


The HP 9000 system administrator may set up a direct PPL connection, which can be initialized 
at boot time or any time thereafter. To set up a direct connection at boot time, the super-user 
inserts a line in the /etc/netlinkrc script like the following: 

ppl -o slip_target 


where slip_target is the name of the target. As mentioned above, the command could be issued 
at any time from the command shell: 
$ ppl -o slip_target. 


For more information about PPL, see HP 9000 Networking, Using Serial Line IP Protocols. 


NOTE 


The two machines should be connected via serial ports. There should not be a 
getty! running on the serial port of the HP 9000/700 work station. 


1. 
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A process invoked by init to set terminal type, line mode speed and line discipline. It is the second process in the 
series (init, getty, login, shell) that ultimately connects a user with the HP-UX system. For details, consult your HP 
9000/700 work station system administrator. 
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3.3.5 Download Script 


For convenience, a download script should be created in the test directory, which is executed in 
the target to download the modules under development. See Figure 3-3. 


ld < fpmUserAppl.o 


Figure 3-3. Sample downLoadScript 


This is an ordinary text file which is executed from the target shell command line. Before 
executing the script, user and working directory where to find the script must be set. This is 
done with the commands: 
-> iam “applicationDeveloper” 
-> cd “slip_host:/ipa/projects’’FPMUserA pplication”/members/”’developer’’/ 

”UserA pplication’/work/FPMUserTest”’ 
-> < downLoadScript 


3.3.6 Task Spawn Script 


For convenience, a task spawn script should be created in the test directory, which is executed in 
the target to spawn the Executive. 


taskSpawn(“tFPMExc’”, 95, 0, 4000, fpmExecMain, 1) 
taskDelay(100) 


Figure 3-4. Sample taskSpawnScript 


This is an ordinary text file which is executed from the target shell command line with the 
command: 
-> < taskSpawnScript. 


NOTE 
The task to be debugged, using vxgdb, should not be spawned. That task is 


spawned under control by vxgdb. 


3.3.7 Debugger Initialization 


For convenience, a start-up file, .vxgdbinit, should be created in the test directory, which is 
executed by vxgdb during start-up. In this file the developer can define paths to the source code 
which is to be debugged, initial breakpoints, which target to connect to etc. See Figure 3-5. 
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target vxworks slip_target 

dir /ipa/products/FPMBase/1.0-0/lib 

dir /ipa/projects/’ FPMUserA pplication’/members/’developer’’/”’ UserApplication”/work/ 
“Application” 


break fpmApp|Main 
run fpmApplmain 


Figure 3-5. A sample .vxgdbinit file 


In order to work, vxgdb must find the symbol table for the load module, resident in Flash 
PROM, in the target. The way to ensure this is to define a softlink named vxWorks.st in the 
developer’s login directory, pointing to the load module generated in /ipa/products/FPMUsr/1.0- 
0. The softlink is created with the following command: 

$ cd 

$ In -s /ipa/projects/FPMBase/1.0-0/source/vwpu535Dev.st vx Works.st. 


3.3.8 Preparation for System Building 


In the Integration subsystem directory /ipa/projects/FPMDemoApplication/nembers/ 
”developer”/DemoApplication/work/Inte gration, make a copy of the PROMed system Makefile 
(makesystem.mk), initAppPU535.c, inet.c, dbsconfi.c, dbsconfi_inc.h and the PROMed system 
generation scripts mkProdSystem, mkTestSystem and mkTestSystem.VxGDB using the 
commands: 

$ cd Integration 

$ cp /Aipa/products/FPMBase/1.0-0/source/MakeSystem.mk ./Makefile 

$ cp /ipa/products/FPMBase/1.0-0/source/initA ppPU535.c . 

$ cp /Aipa/products/FPMBase/1.0-0/source/inet.c . 

$ cp /ipa/products/FPMBase/1.0-0/source/dbsconfi.c . 

$ cp /ipa/products/FPMBase/1.0-0/source/dbsconfi_inc.h . 

$ cp /Aipa/products/FPMBase/1.0-0/source/mkProdSystem . 

$ cp /ipa/products/FPMBase/1.0-0/source/mkTestSystem . 

$ cp /ipa/products/FPMBase/1.0-0/source/mkTestSystem. VxGDB . 


NOTE 


The dot at the end of the above commands denotes the current directory. 
The Makefile is used together with the system generation scripts (mkProtSystem, 
mkTestSystem and mkTestSystem. VxGDB) to build a PROMable system. 


The initAppCI535.c module initializes the Host System Interface and starts the FPM start-up 
task. 


The inet.c module defines two strings, inetHostAddr and inetTargetAddr, which must be edited 
to hold the Internet addresses that is to be used for Host System and Target System. For infor- 
mation on how to select these addresses, see Section 3.3.3 Host/Target Internet Addresses. 
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The dbsconfi.c and dbsconfi_ince.h modules initializes part of the Host System Interface. 
You should not need to change these modules. 


The mkProdSystem module is a script which is used for building a production system. 
A production system excludes networking, SLIP and remote debugging, but includes the FPM 
application. 


The mkTestSystem module is a script which is used for building a development system. 

This system includes support for networking (SLIP) used together with User Test Interface for 
On-line testing of an FPM application installed on PU535. The second RS-232-C 
communication interface (channel two) is used for SLIP communication. The development 
system used when On-line testing contains an Executive that is compiled without debug option. 
You should not need to change this module. 


The mkTestSystem.VxGDB module is a script which is used for building a development 
system allowing remote debugging. Support for networking (SLIP) is included and the 
Executive is compiled with debug option to allow remote debugging of an FPM application 
module installed on PUS35. 


3.4 Application Start-up 


3-10 


There are two methods to start the FPM application installed on the PU535 submodule when 
using the FPM development system: 


° The FPM application installed on the PU535 submodule is spawned, with the cyclicity of 
the AMPL program supervising the FPM application, by the Executive. The Executive is a 
part of the Host Interface of the PU535 submodule. 


The FPM application is only spawned if the FRM-COM element, contained in the AMPL 
program supervising the FPM application, issues a RUN command or a CONTINUE 
command, see Section A.2 PC Elements. 


° The FPM application is started by the debugger vxgdb as defined by the start-up file 
.vxgdbinit used by the debugger vxgdb. To start the debugger give the command below: 


$ vxgdb 
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3.5 Tutorial 


This chapter contains a tutorial of how to implement an FPM application on the PU535 
submodule. The FPM application is written in the programming language C and interacts with 
AMPL modules in the Advant Controller. The development of the mentioned FPM application 
includes the implementation of an AMPL module which supervises the FPM application, 
installed on PU535, and sends data to and receives data from the application. 


FPM installed on PU535 can be used for implementation of a lot of technical applications. The 
example on the following pages tries to clarify the development of an application module, 
linked together with FPM on PUS35, and interfacing with an AMPL module via the dual port 
memory. 


Conditions of the Application example: 


In an advanced control loop implemented using AMPL in an Advant Controller, it is necessary 
to calculate a set point in two different ways depending on some parameters measured by the 
Advant Controller. The two setpoints are calculated with two independent and complex 
formulas. The formulas are also to be protected from copying by unauthorized personnel. The 
conditions above implies that the setpoint should be calculated in an application module, 
written in C, installed together with FPM on PUS35. 


Solution: 


° Depending on the measured input parameters, the AMPL program updates an output 
block, in the dual port memory with a string, indicating to the FPM application module 
calculating the setpoint, which of two formulas to be used. The PC-element FPM-OA is 
used to send the string to the FPM application (A in Figure 3-7). 


° The AMPL program uses the PC-element FPM-O to update output blocks with the 
parameters necessary for calculation of the setpoint (B in Figure 3-7). 


° When the parameters in the dual port memory are updated, the AMPL program sends the 
command RUN to the FPM application, indicating that the calculation of the setpoint 
should start. The PC-element FPM-COM is used to send commands, such as RUN etc., to 
the FPM application (C in Figure 3-7). 


° When the Executive on FPM receives a RUN command the FPM application, calculating 
the setpoint, is executed by the Executive. The FPM application reads the string, indicating 
which of two possible methods for calculation of the setpoint that should be used, from the 
double port memory using the read_JA function in FPMLib. 

Then the input parameters, used for calculation of the setpoint, are read from DPM using 
the read_R function, see Section B.1 FPMLib. 


° Calculation of the set-point is performed and the result of the calculation is stored by the 
FPM application, using the function write_R. The FPM application indicates, using the 
write_IA function, if the value of the calculated setpoint is valid or not, and the execution 
cycle of the FPM application installed on PU535 is terminated. 
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° When the calculation of the setpoint is completed, the AMPL module reads an input block 
containing the string indicating if the value of the calculated setpoint is valid or not, using 
the PC-element FPM-IA (D in Figure 3-7). 


° Finally the value of the calculated setpoint is read from its corresponding input block in 
dual port memory, using the PC-element FPM-I (E in Figure 3-7). 


NOTE 


The first task of the AMPL module is to notify if the calculation of the setpoint, in 
the previous execution cycle, was valid or not and also to read the actual setpoint. 


Configuration of the AMPL application, used for supervising the FPM application module is 
shown below: 


Step by Step Implementation of Supervising AMPL program 


1. Connect AS 110 ES to the host system, that is the Advant Controller. 


2. Give the Command SLLEV PC to enter the application mode, which is used when 
AMPL programs are built. 


3. Configure the PU535 database element as described in Section A.1 Database Element. 


4. Estimate the cycle time for the control module containing the PC-elements used for 
supervising the FPM application module. Choose this cycle time, when inserting the 
PC-element CONTRM, as cyclicity of the control module. The cycle time for the AMPL 
program in this example is set to 1000 ms. 


5. Insert the PC-elements needed to supervise and interface the application module, installed 
on PU535, using the Command IS. The configuration of the AMPL program is shown on 
the next two pages. 


6. Connect input- and output-terminals of the inserted PC-elements towards blocks in double 
port memory, I/O objects, terminals of PC-elements etc. (See configuration of the AMPL 
program in Figure 3-6 and Figure 3-7 on the next pages). The Command C is used when 
connecting terminals using AS 100 ES. 


7. Make sure that your PC program is in build mode. 


NOTE 


If there is a system message indicating that data consistency is lost, when issuing 
a Continue command from the AMPL program supervising the FPM application, 
a longer cycle time must be chosen at step 4 above. 
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PCL. 
CONTRM 
D=1—1—ON (1000) RUN|— 5 
D=0 —— 2 +5 SINGLE MODP |— 6 
D=0 —_3—R 
PC1.1.1 
FPM-IA (D) 
(8) 
D=1 — 1—DBIDENT 
D=4 —_ 2 —jBLOCK ERROR |—_ 4 — 
D=1 — 3 ——~ ENABLE 
DATA |—— 11 —— Indication of valid setpoint 
PC1.1.2 
FPM-I (E) 
(R,1,R,0,R,0,R,0) 
D=1 —— 1 —+DBIDENT 
D=2 —— 2 —jBLOCK ERROR |—_ 4 — 
D=1 — 3 —~+ ENABLE 
DATA |}— 11 —— Calculated setpoint 
PC1.13 
FPM-O 
(R,5,R,5,R,0,R,0) 
D=1—— 1 —+ DBIDENT 
D=-1—— 2 —_|BLOCK ERROR |—— 6 
D=1— 3 —_4 ENABLE 
Setpoint parameter 1 —— 11 —~SIil 
Setpoint parameter 2 —— 12——_|S12 
Setpoint parameter 3 —— 13 ——S13 
Setpoint parameter 4 —— 14——_S14 
Setpoint parameter 5 —— 15—— S15 
Setpoint parameter 6 —— 21— S21 
Setpoint parameter 7 —— 22 ——)S22 
Setpoint parameter 8 —— 23 ——)S23 
Setpoint parameter 9 —— 24——|S24 
Setpoint parameter 10 ——- 25——|S25 


Figure 3-6. AMPL Control module supervising FPM application 
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PC1.1.4 
SW-C 
(B,1) 
Select Formula= 0/1—- 1——| ACT 
D=0 1L 4 13 
D=1 12 
PC1.1.5 


FPM-OA (A) 


(80) 
D=1 — 1 — DBIDENT ERROR ;— 6 


D=3 — 2 —~+ BLOCK 
3 ENABLE 


D=’First’ — 11 —4 DATA 


PC1.1.6 


FPM-OA (A) 


(80) 
D=1 — 1 — DBIDENT ERROR |— 6 
D=3 — 2 — BLOCK 
3 —OENABLE 


D=’Second’ — i —_| DATA 
PC1.1.7 
D=-0 —1—a & 20 
PC1.1:RUN —— 2 —— 
PC1.1.8 
FPM-COM © 
(0) 
D=1 —— 1-—| DBIDENT 
D=1 —— 2 —~+ ENABLE RUNNING|—— 7 —— 
D=0 —— 3 —+RUN ERROR |/—- 8 —— 
5 CONTINUE 


Figure 3-7. AMPL Control module supervising FPM application 
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To implement the FPM application calculating the setpoint, described in the conditions of the 
application example, the steps described below must be performed. For a detailed description of 
SDE and SDE related commands, refer to the SDE product binder. 


Create Environment 


1. Log on into your development system, used when developing an FPM application written 
in the programming language C. 


2. Start the SDE Project Manager, using the projm command in a terminal window and start 
the SDE System Manager using the systm command in another terminal window. 


3. Create the FPMDemoApplication project using the SDE Project Manager. 


4. Create the FPM system using the SDE System Manager and add the system to the 
FPMDemoApplication project using the SDE Project Manager. 


5. Create the FPM application subsystem using the SDE System Manager and add the sub 
system to the FPMDemoApplication project using the SDE Project Manager. 


6. Use the project command under the set menu in the SDE Project manager to set the FEM 
Demo project. The first time you set the project, you should press the “Create work 
directories for all subsystems” Radio Button. This means that the work directories for 
system and subsystems are created automatically, the first time project set is done. 


7. Onconfiguration level /ipa/projects/” FPMDemoApplication/members/’ developer”/ 
DemoApplication/work, make a copy of the makefiles imports.mk, exports.mk and 
internals.mk using the commands: 
$ cp /ipa/products/FPMBase/1.0-0/source/imports.mk . 
$ cp /ipa/products/FPMBase/1.0-0/source/exports.mk . 
$ cp /ipa/products/FPMBase/1.0-0/source/internals.mk . 


8. In the Integration subsystem directory /ipa/projects/F PMDemoApplication/members/ 
”developer”/DemoApplication/work/Integration, make a copy of the PROMed system 
Makefile (makesystem.mk), initAppPU535.c, inet.c, dbsconfi.c, dbsconfi_inc.h and the 
PROMed system generation scripts mkProdSystem, mkTestSystem and 
mkTestSystem.VxGDB using the commands: 
$ cd Integration 
$ cp /ipa/products/FPMBase/1.0-0/source/MakeSystem.mk ./Makefile 
$ cp /ipa/products/FPMBase/1.0-0/source/initA ppPU535.c . 
$ cp /ipa/products/FPMBase/1.0-0/source/inet.c . 
$ cp /ipa/products/FPMBase/1.0-0/source/dbsconfi.c . 
$ cp Aipa/products/FPMBase/1.0-0/source/dbsconfi_inc.h . 
$ cp /ipa/products/FPMBase/1.0-0/source/mkProdSystem . 
$ cp /ipa/products/FPMBase/1.0-0/source/mkTestSystem . 
$ cp /ipa/products/FPMBase/1.0-0/source/mkTestSystem.VxGDB . 


9. Check that the system generation scripts are executable. If they are not, change the access 
rights using the command: 
$ chmod ug+x mkProdSystem mkTestSystem mkTestSystem.VxGDB 


NOTE 


The dot at the end of the above commands denotes the current directory. 


3-15 


Free-Programmable Module 


Chapter 3 Configuration/Application Building 


3-16 


Generate a prommed Test System 


10. 


11. 


12. 
13. 


Edit the file inet.c. Host and Target Internet addresses for the point-to-point SLIP network 
must be specified in this file. How to select Internet addresses is described in Section 3.3.3 
Host/Target Internet Addresses. 


Generate a prommed test system using the command: 

$ mkTestSystem 

This command generates an FPM system load image (vwpu535do.st) without the FPM 
Demo Application which will be dynamically downloaded. It also generates a Motorola S- 
record file (vwpu535do.st.hex) of the load image, that is used by the Flash PROM 
programmer. 


Download the S-record file to the Flash PROM programmer and make the PROMs. 
Install the four Flash PROMs on the CI536 submodule, placed as shown in Figure C-2. 


Build object Modules 


14. 


15. 


16. 


Copy the sample source code and makefile for the demonstration FPM application to the 
FPM application subsystem using the command: 

$ cp /ipa/projects/FPMBase/1.0-0/source/* . 

This command copies the module fpmDemoAppl.c, and a Makefile to the working 
directory. 


Enter the module fpmDemoAppl.c into the editor and go to the function fpmApp]Main. Go 
trough the annotated code example, listed later in this chapter, together with the source 
code for the FPM application entered in the editor. 


Build the object modules from the source code, using the SoftBench Development 


Manager. This will give the module fpmDemoAppl.o. 


NOTE 


The dot at the end of the above commands denotes the current directory. 


Download to Target 


17. 


18. 


19. 


Change directory to the test directory using the command: 
$ cd /ipa/projects/FPMDemoA pplication/members/’’developer’/DemoA pplication/ 
work/FPMDemoTest 


Create a link to the object module created in the development directory using the 

commands 

$ In -s /ipa/projects/FPMDemoA pplication/members/’developer’’/DemoA pplication/ 
work/A pplication/fpmDemoA ppl.o fpmDemoA ppl.o 

Initiate the SLIP connection between the host and target using the command 

$ ppl -o slip_target. 


Login to the target module using the command rlogin slip_target. 
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From the target shell, define user by the command: 

-> iam “developer” and change directory using the command: 

-> cd “slip_host:/ipa/projects/FPMDemoA pplication/members/’’developer’’/ 
DemoApplication/work/FPMDemoTest’’ 


Download the FPM application using the command: 
-> Id < fpmDemoA ppl.o 


Close the SLIP connection using the command: 
-> logout 


Testing the FPM application 


23. 


24. 
25; 


26. 


27. 


28. 


29. 


30. 


From the AS 100 ES, take the PC program out of build mode by using the command 
DIBM. 


From the AS 100 ES, deblock the PC program by using the command DBL. 


The testing of the downloaded FPM application is done from a VT100 terminal or from 
VT100 emulator on HP-UX 9000/700 series, using User Test Interface via an 
asynchronous communication port on the PU535 submodule. The debugger vxgdb can 
also be used when fault-tracing the FPM application. This Tutorial does not describe how 
to fault-trace using the debugger VxGDB. For further details about fault-tracing using 
VxGDB, see Section 3.6.1.4 Remote debugging. 


When using User Test Interface you must start by connecting the terminal that is to be used 
during the test, to the proper terminal port. 


If you are using a VT100 emulator on an HP-UX 9000/700 series machine, you have to 
open an xterm terminal window by using the following command issued from an HP 
Terminal Window: 


$ xterm 


If you are using a VT100 emulator on an HP-UX 9000/700 series machine, you have to 
establish the connection with the PUS35 submodule. From the xterm window, give the 
command below: 


$ rlogin slip_target 

Start the User Test Interface, by executing the C-function fpmUTIMain from VxWorks 
shell as described below: 

-> fpmUTIMain 


Use the User Test Interface shown on your VT 100 terminal or your X-terminal emulating a 
VT100 terminal, connected to the PU535 submodule containing FPM, to test the 
functionality of the application module. Below there is a description of how to read a value 
from the Dual Port Memory (DPM) using User Test Interface (for a complete description 
of the User Test Interface, see Chapter 4 Runtime Operation). 


a. Change the set of dynamic keys on the User Test Interface Menu by pushing the 
dynamic key Mode. 


b. Change the mode of the Executive by pushing the dynamic key OnLineTest. 
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Switch back to the set of dynamic keys for commands by pushing the dynamic key 
ChangeDynKey. 


Execute the demonstration application once by issuing a Continue command from 
UTI: 

Push the dynamic key Continue and give number of cycles = 1 when the User Test 
Interface prompts for it. 


To read values from DPM, push the dynamic key Read. Then enter block number = 1 
and section number = | when they are prompted for. 


When the section number is entered, the values of the elements in this section are 
shown in the Output Window of the User Test Interface. 


If you want to leave the User Test Interface, push the dynamic key Quit. 


NOTE 


Every step, listed above, used to implement an FPM application to be contained 
on PUS535, is in detail described Section 3.6.1 Development of an FPM 
Application Module. 
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struct_APIO* apioPtr; 

struct_DPMApio* dpmApioPtr; 

FpmStatus writeStat; 

FpmStatus readStat; 

int i; 

int block; 

int section; 

int element; 

float apioRVal; 

char apioAStr[80]; 

char* dummyStrP; 

float paramArray[80]; 

float divisor; 

float setpoint; 

PReeoe seo see eh estes se See eases 

Fetch pointer to double port memory 
eA a A Ze oe a SI et */ 
if ((dpmApioPtr = (struct_DPMApio*) 
absBasePointerGet (VxabFpmBasePtr)) == NULL) 
{ 
fpmNullPointerReceived (); 
} 

a a 
Read the string indicating which of the 2 formulas 
for calculation of the setpoint, that should be used. 

Se Se ee es a ee ee ee */ 

block = 3; 

if ((readStat = read_A(apioAStr, block)) != FpmOk) 

{ 

fpmRead_AError (block) ; 

dummyStrP = “Read failed”; 

strncpy(apioAStr, dummyStrP, 11); 

block = 4; 

if ((writeStat = write_A(dummyStrP,block)) != Fpmok) 
{ 
fpmWrite_AError (block); 
} 

exit (ERROR) ; 

} 
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FPM application module used for calculating a setpoint: 


void fpmDemoApp1Main (void) 
{ 
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Read the input parameters that should be used 
when calculating the setpoint 


Se a a ee ee ee eee */ 
i = 0; 
block = 1; 
for(section = 1; section < 3; section++) 
{ 
for(element = 1; element < 6; elementt+t) 
{ 
if((readStat = read_R((&apioRVal), block, 
section, element)) != Fpm0Ok) 
{ 
fpmRead_RError (block, section, element); 
dummyStrP = “Read failed”; 
strncpy(apioAStr, dummyStrP, 11); 
block = 4; 
if((writeStat = write_A((apioAStr, block)) != Fpmok) 
{ 
fpmWrite_AError (block); 
} 
exit (ERROR) ; 
} 
paramArray[i] = apioRVal; 
itt; 
} 
} 
ik Set Se ae Pe OO Se oe Se 
Check which of 2 possible formulas that should 
be used to calculate the setpoint 
Se ee a ee a ee ee */ 
if(!strncmp(apioAStr, “First”, 5)) 
{ 
fRose Sp eee ee Stee eee ee 
Check if divisor is equal to 0 
aE Bee Ne eee Ieee Re ROD TIE SEN SERIE OR TEN EP */ 
if((divisor = paramArray[0] + paramArray[1]) == 0) 
{ 
fpmDivideByZero) ; 
dummyStrP = “Divide by zero”; 
strncpy(apioAStr, dummyStrP, 14); 
block = 4; 
if ((writeStat = write_A(dummyStrP,block)) != Fpmok) 


{ 
fpmWrite_AError (block); 


} 
exit (ERROR) ; 
} 
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setpoint = ((paramArray[2] + paramArray[3]) + 
(paramArray[4] / divisor)); 


else if (!strncmp(apioAStr, “Second”, 6)) 
{ 
setpoint = (paramArray[5] + paramArray[6] + paramArray[7] + 
paramArray[8] + paramArray[9]); 
} 


else 
{ 
dummyStrP = “Error -— the formula must be either First or Second.”; 
strncpy(apioAStr, dummyStrP, 51); 
block = 4; 
if ((writeStat = write_A(dummyStrP,block)) != Fpmok) 


{ 
fpmWrite_AError (block) ; 
} 
exit (ERROR) ; 
} 
block = 2; 
section = 1; 
element 1 
if((writeStat = write_R((&setpoint), block, section, element) ) 
!'= FpmOk) 


{ 
fpmWrite_RError (block, section, element); 
} 


dummyStrP = “Data is valid”; 

strncpy(apioAStr, dummyStrP, 13); 

block = 4; 

if((writeStat = write_A(apioAStr, block)) != FpmOk) 


{ 
fpmWrite_AError (block) ; 
} 


3BSE 001 688R0001 Rev A 3-21 


Free-Programmable Module 
Chapter 3 Configuration/Application Building 


3.6 Application Procedures 


The main steps of the development of an FPM application module and the AMPL-program 
supervising the module are listed below: 


1. Connect AS 100 ES to the target system, that is the Advant Controller. 
2. Create and configure the DB element PU535. 


3. Use AMPL building commands to make an application module to supervise the FPM 
application which is installed on PU535. The application module should contain an FPM- 
COM element, used for supervising the FPM application, and the for interfacing with the 
PU535 needed FPM-I, FPM-IA, FPM-O and FPM-OA elements. 

Secure the data consistency between the AMPL module and the FPM application module, 
see Section 3.1 Design Considerations. 


4. Log on into the development system, used when developing the FPM application which is 
to be installed on PU535. 


5. Invoke a suitable editor, such as softedit etc., and start the development of the FPM 
application which is going to interact with the AMPL program via the dual port memory. 
The FPMLib routines (See Section B.1 FPMLib) should be used by the FPM application to 
interface with the AMPL module. 
Note that the main function of the program must be named fpmApp!]Main. 


6. When the development is completed leave the editor and save the module. 
7. Compile the source code, to create a file of object code. 


8. Establish a connection to the PU535 submodule, containing FPMBase, FPMLib and other 
necessary system software, via the second of the asynchronous communication ports of the 
submodule. The SLIP protocol is used when communicating with the PU535 submodule. 


9. Download the file, containing the object code of the developed FPM application. 


10. Test the developed FPM application using vxgbd and the User Test Interface. 


3.6.1 Development of an FPM Application Module 


This is a summary of the steps necessary to implement an FPM application module using FPM. 


If you are using SDE, you have to install and set it up. See Section 2.2.2.1 SDE for installation 
and Section 3.3.1 SDE for initialization of SDE. This is essential for step 1 and step 2 below. 


You have to install and set-up FPMBase. This is essential for step 2, 3, 4 and 5 below. 


You have to install and initialize PPL (SLIP). See Section 2.2.2.2 SLIP for installation and 
Section 3.3.4 SLIP Interface for initialization of PPL. This is essential for step 3 and step 4 
below. 


The steps below are more thoroughly described in later subsections and they correspond to the 
numbers in Figure 3-8. 


1. Create source code 


— Select a proper editor. The SoftBench editor (softedit) is the first-hand selection, but 
other editors such as emacs or vi will do. 
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Compile the source code 


— You have to generate a makefile or use the makefiles provided for the FPM Demo 
application. 


Download to target 


— Internet addresses for host and target machines have to be selected, see Section 3.3.3 
Host/Target Internet Addresses 


— A download script may be used, see Section 3.3.5 Download Script. 
Debug the FPM application in target 


— The remote debugger has to be initialized. A start-up script may be used, see Section 
3.3.7 Debugger Initialization. 


On-Line test using the User Test Interface 


— The User Test Interface is started to perform on-line testing, see Section 4.4 
Operating Instructions 


Build a prommable system 
Prom the system generated 


— You need a PROM programmer with support for 28FO20 type Flash PROMs 


NOTE 


This manual does not describe in detail how to use SDE tools. For a detailed 
description of SDE, refer to the SDE Product binder. 
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Figure 3-8. FPM Application Implementation Steps 
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3.6.1.1 Create Source Code 


The items mentioned in Section 3.1 Design Considerations should be considered before you 
start to implement the FPM-application module, that is: 


Specify the cyclicity of the AMPL program which is going to supervise the FPM 
application installed on PUS35. The FPM application, contained on PU535, is spawned 
with the cyclicity that is specified for the AMPL program. 


Specify the exchange of data between the AMPL-program and the FPM application 
contained on PU535. The blocks in the double port memory is either specified to be used 
when the application module reads data from the AMPL-program, or when the application 
module sends data to the AMPL-program. The data-type of the sections used in every 
block, must also be specified. 


Decide if the FPM application that is to be implemented demands consistent data transfer 
from the AMPL program to the FPM application and vice versa, see Section 3.1 Design 
Considerations 


If you are using SDE, the following steps are taken: 


1. 


5. 


Start the SDE Project Manager, using the projm command in a terminal window and start 
the SDE System Manager using the syst#m command in a terminal window. 


Create the project FPMUserApplication (or any other name of your choice), using the SDE 
Project Manager. 


Create the system UserApplication (or any other name of your choice), using the SDE 
System Manager and add the system to the project created, using the SDE Project 
Manager. 


Use the project command under the set menu in the SDE Project manager to set the 
project. Work directories for system and sub system will be created automatically, the first 
time project set is done. 


Create the source code using the editor of your choice. 


If you are not using SDE you are on your own as far as project handling and source code 
handling is concerned. The following steps are taken: 


1. 
2, 


Create your working directory structure. 


Create the source code using the editor of your choice. 


3.6.1.2 Compile the Source Code 


If you are using SDE, the following steps are taken: 


1. 


OS 
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A makefile must be generated. This is done using the SDE/SoftBench Program Builder. 
Use the SDE/SoftBench program Builder to build the object module(s). 
Correct any remaining errors using the editor. 


Repeat step 2 and 3 until the object module(s) are correctly built. 
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If you are not using SDE, the following steps are taken 


1. A makefile must be generated. This is done using the following command with current 
directory set to the directory containing the source code: 
$ mkmf 
Note that the mkmf program scans all files in the current directory, so the directory should 
only contain the source code and include files that implements the FPM application. 


2. Build the object module(s) using the following command: 
$ make 


3. Correct any remaining errors using the editor. 


4. Repeat step 2 and 3 until the object module(s) are correctly built. 


3.6.1.3 Download to Target 


Assuming that a FPMBase development system is generated and installed as described in 
Section 3.6.1.6 Build a Prommed System, and that the SLIP communication link between the 
HP 9000/700 work station and PU535 is set up and working, the following steps are taken: 


1. Change current directory to the test directory: 
$ cd /ipa/projects/FPMUserA pplication/members/’’developer’’’’ UserA pplication’’/ 
work/FPMUser Test 


2. Copy your object module to the test directory specified above. 


3. login to the target system: 
$ rlogin slip_target 


4. You are now logged in on the target system and the VxWorks shell prompt is visible: 
-> 


5. Set up the developer’s login id and change current directory to the test directory in the 
work station: 
-> iam “developer” 
-> ced “slip_host:/ipa/projects/FPMUserA pplication/members/’’developer’’/ 
”UserA pplication’/work/FPMUserTest”’ 


6. You are now ready to download your object module fpmAppl.o (or any other name of your 
choice) into the target system. This is done using the VxWorks linking loader: 
-> Id < fpmAppl.o 
Note that this could be done using a download script as described in Section 3.3.5 
Download Script 
-> < downLoadScript 


3.6.1.4 Remote debugging 


There is a possibility to use remote debugging on an FPM application downloaded to PU535. To 
fault trace the FPM application the User Test Interface (see Section 3.6.1.5 User Test Interface) 
and vxgdb is used. Assuming that an FPMBase development system is generated and installed 
as described in Section 3.6.1.6 Build a Prommed System and that the SLIP communication link 
between the HP 9000/700 work station and PU535 is set up and working, the following steps 
are taken: 


3-26 3BSE 001 688R0001 Rev A 


Free-Programmable Module 
Section 3.6.1 Development of an FPM Application Module 


Open an HP Terminal Window, set the FPMUserTest directory as current directory and 
start the remote debugger with the command described below: 
$ vxgdb 


Initiate the debugger. Do this from the VxGDB command line. 


a. Connect to the target to be debugged: 
$ (vxgdb) target vxworks slip_target 


b. Define the directory where the source code to be debugged is found using the 
following command: 
(vxgdb) dir /ipa/projects/’”FPMUserA pplication’’/members/’’developer’’?/ 
”UserA pplication’/work/’ Application” 


c. Define the initial breakpoint from which to start debugging: 
(vxgdb) break fpmA ppIMain 


d. Start the debugger with the following command: 
(vxgdb) run fpmAppIMain 


The debugger is now initiated and ready to run the FPM application from the initial 
breakpoint. 


NOTE 


You must build the right kind of FPM system, see Section 3.6.1.6 Build a 
Prommed System. 

When using UTI, an AMPL-program, initializing and supervising the double 
port memory, must be configured. 


3.6.1.5 User Test Interface 


There is a module called User Test Interface contained in FPM. The module (see Section 4.5 
Runtime Operation Menus) can be used when On-line testing the FPM application downloaded 
to PUS35. 

Assuming that a FPMBase development system is generated and installed (see Section 3.6.1.6 
Build a Prommed System) and that the SLIP communication link between the HP 9000/700 
work station and PUS35 is set up and working, the following steps are taken when starting the 
execution of the User Test Interface. 
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1. 


Open a terminal window (XTERM), emulating a VT100 terminal, and login to the target 
system: 
$ rlogin slip_target 


Start User Test Interface with the command below: 
-> fpmUTIMain 


NOTE 


You must build the right kind of FPM system, see Section 3.6.1.6 Build a 
Prommed System. 

When using FPM an AMPL-program, initializing and supervising the double 
port memory, must be configured. 
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3.6.1.6 Build a Prommed System 


When the operating system is finished with its start-up procedures, the application (FPM) is to 
be started. This is done calling a function, initApp, which initiates the host system interface and 
spawns the Executive. 


There are three kinds of FPM Systems that can be built: 


° A development system which includes support for networking (SLIP) and where the 
Executive is compiled with debug option to allow remote debugging of an FPM 
application module installed on PUS35. The script used is mkTestSystem.VxGDB. 


° A development system which includes support for networking (SLIP) used together with 
User Test Interface for On-line testing of an FPM application installed on PU535. The 
development system used when On-line testing contains an Executive that is compiled 
without debug option. The script used is mkTestSystem. 


° A production system which excludes networking, SLIP and remote debugging, but 
includes the FPM application. The script used is mkProdSystem. 


Development Systems 


Assuming that FPMBase is installed as described in Section 2.2.2 Software, the following steps 
are taken to build a development system: 


1. Change current directory to the user development structure 
$ cd /ipa/projects/’FPMUserA pplication”/members/’’developer’’?/’’UserA pplication’’?/ 
work/Integration 


2. Before an FPMBase system is built, the internet addresses for the host (HP 9000/700 work 
station) and the target (PU535 submodule) must be specified. See Section 3.3.3 
Host/Target Internet Addresses for details. 


3. Build the system using the following script: 
$ mkTestSystem 
This command generates a non-relocatable load module vwpu535od.st and an s-record file 
named vwpu535od.st.hex. 


If a system used for remote debugging is to be built, use the following script: 

$ mkTestSystem. VxGDB 

This command generates a non-relocatable load module vwpu535od.st and an s-record file 
named vwpu535od.st.hex. 


4. The s-record file is the file to be downloaded to the FlashProm programmer and prommed. 
5. Install the FlashProms into the PU535 submodule 


6. Install the submodule into the AC 400 Process Station, and it is ready for use. 
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Production System 


Assuming that FPMBase is installed as described in Section 2.2.2 Software, the following steps 
are taken to build a production system: 


1. 


Change current directory to the user development structure 
$ cd /ipa/projects/’FPMUserA pplication’”’/members/”’developer’’/”’UserA pplication’’/ 
work/Integration 


Before an FPMBase system is built, the internet addresses for the host (HP 9000/700 work 
station) and the target (PU535 submodule) must be specified. See Section 3.3.3 
Host/Target Internet Addresses for details. 


Build the system using the following script: 
$ mkProdSystem 


The s-record file, vwpu535o.st.hex, is the file to be downloaded to the FlashProm 
programmer and prommed. 


Install the FlashProms into the PU535 submodule 


Install the submodule into the AC 400 Process Station, and it is ready for use. 


3.7 Configuration/Application Building Menu 
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There are two groups of Configuration, Application and Building Menus used together with 
FPM: 


On-Line Builder used to configure AMPL application, for details please refer to AMPL 
Configuration Advant Controller 400 Series. 


SDE used to build FPM application, for details please refer to SDE product binder. 
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Chapter 4 Runtime Operation 


4.1 Product Operation 


The AC 400 must be in runtime mode (mode P1, indicated on the front of the main processor 
module) to be able to exchange data with PU535. With the AC 400 in configuration mode 
(mode P2, indicated on the front of the main processor module), no exchange of data is 
performed with PUS35 


The control of the execution, and the interfacing with an FPM application installed on PU535 
can be supervised in two different ways: 


° A Control module in an AMPL program using the PC-element FPM-COM to control the 
execution of the FPM application and the PC-elements FPM-I, FPM-O, FPM-IA and 
FPM-OA for exchange of data with the FPM application. 


° User Test Interface which is a software module that is a part of FPM. The User Test 
Interface uses a menu presented on a VT100 terminal or a VT100 emulator on HP-UX 
9000/700 series connected to the PU535 submodule for control and exchange of data with 
the PU535. From the mentioned menu commands for control, exchange of data and 
different execution modes can be given. The User Test Interface is normally used for test 
and evaluation purposes. 


4.2 Operating Overview 


After start-up, and with the AC 400 in runtime mode, the FPM application installed on PUS35 
can be supervised as described below: 


° From the AMPL program for activation of commands and exchange of data 
— Initializing, executing and terminating the FPM application installed on PU535 
— Exchanging data with the FPM application installed on PU535 

° From User Test Interface for activation of commands and exchange of data 
— Initializing executing and terminating the FPM application installed on PUS35 


— Exchanging data with the FPM application installed on PU535 


4.3 Runtime Tutorial 
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As described in Section 4.2 the FPM application installed on PU535 can be supervised either 
from an AMPL-program or from the User Test Interface. There are several commands that 
could be issued to control the FPM application installed on PU535 from both the AMPL- 
program and the User Test Interface. These commands are described below: 
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AMPL Commands 


The AMPL Commands are issued by connecting values to terminals of the FRM-COM 
PC-element. The commands that can be issued are: 


Run: The Run command initializes the double port memory, i. e. all the output 
elements are set to zero, during the first execution cycle. Then the FPM 
application is executed, i. e. the application performs its tasks and exchanges 
data with the AMPL program via the double port memory. 


Continue: The Continue command executes the FPM application installed on PUS35, 
i. e. the application performs its tasks and exchanges data with the AMPL 
program via the double port memory. 


Stop: The Stop command stops the execution of the FPM application installed on 
the PU535 submodule. 


For more detailed instructions of how to design the AMPL program supervising the FPM 
application installed on PU535, see Section 3.5 Tutorial 


User Test Interface Commands 


The User Test Interface has four different execution modes. They are Normal, OnLineTest, 
DisconnOutput and Disconnect. The modes are described thoroughly in Section 4.5.3 User Test 
Interface Menu with dynamic keys for changing mode. 


The commands available in the User Test Interface are issued by pushing function keys on the 
numeric key-pad of the terminal connected. Note that the commands below cannot be issued in 
mode Normal. 


Run: In the User Test Interface you must choose how many times, i. e. the number 
of AMPL cycles, to execute the FPM application. It is possible to let the 
application execute continously until a Stop command is issued. 


Depending on the current mode of UTI, the Run command always initializes 
the double port memory or the local test environment, during the first 
execution cycle. Then, if the number of AMPL cycles is else than one, the 
FPM application is executed and data is exchanged in the manner that 
corresponds to the current mode. 


Continue: In the User Test Interface you must choose how many times, i. e. the number 
of AMPL cycles, to execute the FPM application. It is possible to let the 
application execute continously until a Stop command is issued. 


The Continue command executes the FPM application installed on 
PUS35, i.e the application performs its tasks and exchanges data in the 
manner that corresponds to the current mode of UTI. 


Stop: The Stop command is used to break a cyclic execution of the FPM application 
installed on PU535. 


The User Test Interface provides several more commands. For a detailed description of the 
complete set of commands and how to issue them from the User Test Interface, see Section 4.5.2 
User Test Interface Menu with dynamic keys for commands. 
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4.4 Operating Instructions 
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The User Test Interface can be executed via a VT100 terminal or a VT 100 emulator on HP-UX 
9000/700 series. When executing User Test Interface via a VT 100 terminal the following steps 
are performed: 


1. 
2. 


Connect the VT100 terminal to port! of PU535 submodule. See Section 2.2.1. 


To start the User Test Interface give the command 


-> fpmUTIMain 


To issue User Test Interface Commands the function keys on the numeric key-pad are 
used, see Section 4.5 Runtime Operation Menus. 


To execute User Test Interface via a VT100 emulator on HP-UX 9000/700 series follow the 
steps below: 


1. 


Open a VT100 emulator and login to the target system: 
$ rlogin slip_target 


Start User Test Interface with the command below: 


-> fpmUTIMain 
To issue User Test Interface Commands the function keys on the numeric key-pad are 


used, see Section 4.5 Runtime Operation Menus. 


NOTE 


To be able to work with the User Test Interface, an FPMSystem generated with an 
Executive compiled without debug option must be used. An AMPL program, 
initializing and supervising the double port memory, must also be configured. 
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4.5 Runtime Operation Menus 


The User Test Interface is normally used for test of an FPM application installed on PU535. 
There are mainly three types of commands that can be issued from the User Test Interface 
Menu. 


1. Commands for supervising the execution of the FPM application installed on PUS35. 
2. Commands for reading and writing data to the double port memory. 
3. Commands for changing the mode of User Test Interface. 


The commands specified by 1. and 2. above share the same set of dynamic keys and the 
commands specified as 3. above has its own set of dynamic keys. The complete set of 
commands and functions that can be issued from the User Test Interface are handled by the two 
sets of dynamic keys described in later sections. 


4.5.1 Data types available in FPM 


4-4 


Data to read or write to the double port memory can be of one of the following types: 
° String 

° Boolean 

° Integer 

° Integer Long 

° Real 

° Time 


° Time Real 


The data types Time and Time Real need some special attention. 


While working from the User Test Interface, the Time values are represented as a number in the 
following range: 


[0 ... 863999990] tenths of milliseconds. 


While working with FPM from an Advant Station 100 ES by using the PC-elements, Time 
values are represented in seconds. 


Example: 
The Time value 14 seconds is given from the Advant Station 100 ES. 


When this value is read from the double port memory using User Test Interface, it will be 
represented as 140000 tenths of milliseconds. 


The Advant Station 100 ES represents values greater than 59 seconds in the following way: 


hour : minute : second 
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Examples: 

78 seconds will be represented as 1 : 18 

567 seconds will be represented as 9 : 27 

10000 seconds will be represented as 2 : 46 : 40 


Both in the Advant Station 100 ES and in the User Test Interface, Time Real values are 
represented as a number in the following range: 


[0.0 ... 9.199999E18] seconds. 


4.5.2 User Test Interface Menu with dynamic keys for commands 


The Figure below shows the User Test Interface Menu with the set of dynamic function keys 
used for issuing commands supervising the FPM application installed on PU5S35, and 
exchanging data with the double port memory. 


Free Programmable Module Test Environment 


Output window: 


Execution mode is Normal 


Ready to receive command 


Application not executing 


Run Stop Continue Read Write Mode Refresh Quit 
<Num1> | <Num2>] <Num3> <Num4> <Num5> <Num6> <Num7> <q> 


Figure 4-1, User Test Interface Menu with dynamic keys for Commands. 
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4.5.2.1 Run 


4.5.2.2 Stop 


4.5.2.3 Continue 
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Below there is a description of how to use the dynamic keys in Figure 4-1 to issue the 
commands and the functions corresponding to the set of the mentioned dynamic keys. 


In the User Test Interface you must choose how many times, i. e. the number of AMPL cycles, 
to execute the FPM application. It is possible to let the application execute continously. The 
cyclic execution continues until a Stop command is issued, see Section 4.5.2.2 Stop. 


Depending on the current mode of UTI, the Run command always initializes the double port 
memory or the local test environment, during the first execution cycle. Then, if the number of 
AMPL cycles is else than one, the FPM application is executed and data is exchanged in the 
manner that corresponds to the current mode, see Section 4.5.3 User Test Interface Menu with 
dynamic keys for changing mode. 


When pushing the numeric key 1, the dialog for the run command issued from the User Test 
Interface is started. Below there is a description of how to complete the Run command. Note 
that it is possible to cancel the command by pushing the key <c>. 


1. The text below is shown in the Input Window 


Give number of AMPL cycles to run [0..9]. 
To let the application free run, give 0. To cancel the command, press <c>. 


2. Enter the number of AMPL cycles to be executed and push the key <ENTER> on the 
numeric key-pad or cancel the command. If you want the FPM application to execute 
continuously, enter 0. 


NOTE 


The Run command cannot be issued from UTI in mode Normal. 


The only way to break a cyclic execution of the FPM application is to issue a Stop command. 


When pushing the numeric key 2, the Stop command is issued from the User Test Interface. 
This means that the FPM application is stopped and the text below is shown in the Input 
Window of the menu described in Figure 4-1. 


Application not executing 


NOTE 


The Stop command cannot be issued from UTI in mode Normal. 


In the User Test Interface you must choose how many times, 1. e. the number of AMPL cycles, 
to execute the FPM application. It is possible to let the application execute continously until a 
Stop command is issued. 
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The Continue command executes the FPM application installed on PUS35, i. e. the application 
performs its tasks and exchanges data in the manner that corresponds to the current mode of 


UTI. 


When pushing the numeric key 3, the dialog for the Continue command, issued from the User 
Test Interface, is started. Below there is a description of how to complete the Continue 
command. Note that it is possible to cancel the command by pushing the key <c>. 


1. 


4.5.2.4 Read 


The text below is shown in the Input Window 


Give number of AMPL cycles to run [0..9]. 
To let the application free run, give 0. To cancel the command, press <c>. 


Enter the number of AMPL cycles to be executed and push the key <ENTER> on the 
numeric key-pad or cancel the command. If you want the FPM application to execute 
continuously, enter 0. 


If you continue, the text below is shown in the input window (see Figure 4-1). 
Application executing 


NOTE 


The command Continue cannot be issued from UTI in mode Normal. 


When pushing the numeric key 4, the dialog for the Read command, issued from the User Test 
Interface, is started. Below there is a description of how to complete the Read command. Note 
that it is possible to cancel the command by pushing the key <c>. 


1. 
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The text below is shown in the Input Window: 
Give a block number in the range [1..50] 
or press <c> to cancel the command. 


Answer with a block number and terminate with the <ENTER> key on the numeric key- 
pad or cancel the command. 


If you continue, the block number is printed in the Output Window and the text below is 
shown in the Input Window: 

Give a section number in the range [1..4] 

or press <c> to cancel the command. 


Answer with a section and terminate with the <ENTER> key on the numeric key-pad or 
cancel the command. 


If you continue, the section number and every used element together with its 
corresponding value are printed out in the Output Window. 
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4.5.2.5 Write 


NOTE 


The command Read can only be issued if FPM is in mode OnLineTest, 
Disconnect or DisconnOutput. 


When pushing the numeric key 5, the dialog for the Write command, issued from the User Test 
Interface, is started. Below there is a description of how to complete the Write command. Note 
that it is possible to cancel the command by pushing the key <c>. 


il 
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The text below is shown in the Input Window: 
Give a block number in the range [1..50] 
or press <c> to cancel the write command. 


Answer with a block number and terminate with the <ENTER> key on the numeric key- 
pad or cancel the command by pushing the key <c>. 


If you continue, the block number is printed in the Output Window and the text below is 
shown in the Input Window: 

Give a section number in the range [1..4] 

or press <c> to cancel the write command. 


Answer with a section and terminate with the <ENTER> key on the numeric key-pad or 
cancel the command by pushing the key <c>. 


If you continue, the section number is printed in the Output Window and the text below is 
shown in the Input Window: 

Give an element number in the range [1..5] 

or press <c> to cancel the write command. 


Answer with an element number and terminate with the ENTER key on the numeric key- 
pad or cancel the command by pushing the key <c>. 


If you continue, the element number is printed in the Output Window and the text below is 
shown in the Input Window (the dialog differs a little depending on the current datatype, 
but the dialog is similar to the one described below): 


Give a value to write into element 
or press <c> to cancel the write command. 


Give a value and terminate with the <ENTER> key on the numeric key-pad or cancel the 
command. If you continue and the Write command is successful, the value written will be 
printed in the Output Window. Otherwise an error-message will be given. 


NOTE 


The command Write can only be issued if FPM is in mode Disconnect. 
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4.5.2.6 Mode 


4.5.2.7 Refresh 


4.5.2.8 Quit 
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When pushing the numeric key 6 the Mode command is issued from the Executive. 

This means that the User Test Interface Menu is refreshed and that the numeric keys are 
changed to the set of numeric keys used for changing the mode of the Executive, see Figure 4-2. 
The text below is shown in the Input Window. 


Ready to receive command for changing mode 


When pushing the numeric key 7, the Refresh command is issued from the User Test Interface. 
This means that the User Test Interface Menu is updated and the Input and Output windows are 
cleared. 


When pushing the key <q>, the Quit command is issued and the User Test Interface session is 
ended. The text below is shown in the Output Window and the execution of the software 
implementing the User Test Interface is stopped. 


Leaving User Test Interface Menu! 
Exit from UTI! 
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4.5.3 User Test Interface Menu with dynamic keys for changing mode 


Figure 4-2 below shows the User Test Interface Menu with the set of dynamic functions keys 
used when issuing commands to change the mode of FPM. 


Free Programmable Module Test Environment 


Output window: 


Execution mode is Normal 


Ready to receive command for changing mode 


Application not executing 


Normal OnLineTest DisconnOutput | Disconnect ChangeDynKe 
<Num1> <Num2> <Num3> <Num4> <Num5> 


Figure 4-2. User Test Interface Menu with dynamic keys used to change the mode of FPM. 
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Below there is a description of how to use the dynamic keys in Figure 4-2 to issue the 
commands and the functions corresponding to the mentioned set of dynamic keys. 


NOTE 


Disconnect is the only mode where it is possible to write values from the User 
Test Interface. The values are only updated locally in the test environment. They 
are not updated in the double port memory. 


4.5.3.1 Normal 


When pushing the numeric key 1, the Executive is set in mode Normal. This means that the 
commands to the Executive are issued from the AMPL program in the Advant Controller 
supervising the FPM application. The Executive updates and reads elements in the double port 
memory. 


4.5.3.2 OnLineTest 


When pushing the numeric key 2, the Executive is set in mode OnLineTest. This means that the 
commands to the Executive are issued from the User Test Interface. The Executive updates and 
reads elements in the double port memory. 


4.5.3.3 DisconnOutput 


When pushing the numeric key 3, the Executive is set in mode DisconnOutput. In mode 
DisconnOutput the commands to the Executive are issued from the User Test Interface and data 
is read from the double port memory. However, when executing the FPM application, the values 
are only updated locally in the test environment. This means that the Executive does not update 
any elements in the double port memory to be read by the input elements in the AMPL program, 
supervising the FPM application installed on PUS35. 


4.5.3.4 Disconnect 


When pushing the numeric key 4, the Executive is set in mode Disconnect. In mode Disconnect 
the commands to the Executive are issued from the User Test Interface. The Executive does not 
update or read any elements in the double port memory. Values are only updated locally in the 
test environment. 


The Executive must be in mode Disconnect to allow values to be written from User Test 
Interface. 


NOTE 


In this mode, if you want to execute the FPM application with values not equal to 
zero, you have to issue a Continue command. If you issue a Run command in 
mode Disconnect, both the input and output blocks will be reset locally. They will 
remain reset until they are updated by a Write command issued from UTI. 
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4.5.3.5 ChangeDynKey 


When pushing the numeric key 5, the dialog for the ChangeDynKey command issued from the 
User Test Interface is started. Below there is a description of how to complete the 
ChangeDynKey command 


1. The User Test Interface Menu is refreshed and the dynamic keys are changed to the set 
of dynamic keys used for sending commands to the FPM application installed on PUS35, 
see Figure 4-1. 


2. The text below is shown in the Input Window: 


Ready to receive command 
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Chapter 5 Maintenance 


5.1 Preventive Maintenance 


The stack usage for the Executive should be checked during runtime. This is done using the 
command checkStack from the console. 


For example: 
-> checkStack 


tHostInt fpmExecMain 23e1c78 4000 832 3968 32 


where the different entities are: 


NAME - task name. 

ENTRY- task entry point, i.e. the main function. 
TID - task identity. 

SIZE - the total stack size. 

CUR - the current number of stack bytes used. 
HIGH - the maximum number of stack bytes used. 


MARGIN - the number of bytes never used at the top of the stack (SIZE - HIGH). 


The margin should not be less than 75% of the total stack size during normal operation. 


5.2 Hardware Indicators 
The PU535 submodule has two LED indicators on the front: 


5.3 Error Messages 
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The green LED is lit when the database element PU535 for the PU535 submodule is 
correctly filled in (see Section A. 1 Database Element) and the PC program to supervise the 
FPM application is deblocked. The terminal IMPL and SERVICE must be set to 1 on the 
PU535 element. 


The red LED is lit when a fatal error is detected on the PU535 submodule. 


This part of the document lists all system messages that might be generated from the PUS35 
submodule. System messages from the AC 400 system software are not included. For 
translation of system messages from the AC 400, please refer to the AC 410 User’s Guide or AC 
450 User’s Guide. 
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System message printouts on the Advant Station 120 ES have the following appearance: 
Node Time Mcode 


01 23 S07* 13:25:09 296x tFPMExc H’00000000 H’12345678 H’12345678 


le al Eo alec, dlls alll 


Netw _ Slave no Mtype Task-name Trace number/ Datal Data2 
Address 


Figure 5-1. System message layout 


All system messages have: 
- Mtype = 29 
¢ Task name = tFPMExc 


Table 5-1. Messages with Mcode =64 and Task name = tFPMExc from PU535 


idee. Number Parameter description 
; 1 = data1 Comments and suggested actions 
(Hexadecimal) 
2 = data2 
0002000c 1: - File Descriptor Failed to start watchdog timer device. 
2: - Internal error, please contact ABB. 
0005000f 1: - Failed to spawn FPM application task. 
2: - Internal error, please contact ABB. 
00060010 1:- FPM application task not terminated. Decrease the cyclicity 
2: - of the AMPL-program that supervises the FPM application. 
0006000f de? Executive in illegal mode. 
2: - Internal error, please contact ABB. 
000600011 1: - Illegal WakeupReason received. 
2: - Internal error, please contact ABB 
00040002 1:- Failed to create FIFO device. 
2: - Internal error, please contact ABB. 
00020002 1:- Failed to create timer device. 
2: - Internal error, please contact ABB. 
00040004 1:- File Descriptor Failed to open FIFO device. Check that the FIFO device is 
2: - properly created. 
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5.4 Fault Finding and User Repair 


5.4.1 SLIP Communication 


If you have followed the instructions in Chapter 2 Installation and Chapter 3 
Configuration/Application Building and the link between host and target machines still does not 
work, please check the following: 


1. Itis not possible to “rlogin” to, or “ping” the PU535 target. 


Check that PPL is correctly configured. This is done in the /usr/lib/pp\/ppl.remotes file. 
See Section 3.3.4 SLIP Interface for details. 


Check that the internet addresses for host and target is correctly configured in both host 
and target. See Section 3.3.4 SLIP Interface for details. 


Check that the PPL network interface device file /dev/ni exists and is correctly defined 
using the command: 

$ Is -1 /dev/ni 

the major number should be 56 and the minor number 0. See Section 3.3.4 SLIP Interface 
for details. 


Check that the serial port device file used for SLIP connection, /dev/ttyxx, exists and is 
correctly defined using the command: 

$ Is -1 /dev/tty* 

the major and minor number values depend on a number of details concerning your 
HP9000/700 work station. See your HP9000/700 system administrator for details. 


Check that ppl is running using the command: 

$ ps -elf | grep “ppl -o slip_target” This should result in something like: 

1S la 27268 3590 3 154 20 baef380 15 453994 16:19:51 ttyq1 0:00 ppl -o 
< slip_target.! 


Check that the FPMBase system on the PU535 submodule is a development system, that 
is, a system with support for networking, SLIP and remote debugging. See Section 3.6.1 
Development of an FPM Application Module for details. 


Check that the SLIP communication cable between host and target is correctly wired. See 
Section 2.2.1 Hardware for details. 


2. You can “rlogin” to the target, but you cannot, from the target, access the 
file system on the host. 


The PU535 target name (slip_target) must be entered in either /etc/hosts.equiv or 
$HOME”/.rhosts on your HP9000/700 work station. 


In /usr/adm/inetd.sec you must define that the PUS35 target is allowed to use the remote 
services shell (remote shell), login (remote login) and rexd (Remote Procedure Calls) to 
access the HP9000/700 host. 


1. For details on how to interpret the output from the ps command, refer to the on-line manual page for ps (man ps). 
Note that this output line is just an example. The values for the different fields will vary from time to time. 
2. Assuming that korn shell is used, $HOME is equivalent to the developer’s login directory. 
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5.4.1.1 Editor 


5.4.1.2 Compiler 


5.4.1.3 Debugger 


5-4 


If your favorite editor is not invoked by the proper command, the path may not be defined in 
$PATH, or it may not be installed on your HP9000/700 work station. Talk to your HP9000/700 
system administrator for assistance. 


If the compiler is not invoked by the proper command or if it is not working correctly, check the 
following: 


Is FPMBase properly installed? 


Is the path to cross development tools /ipa/products/F PMBase/1.0-0/bin set up in the 
PATH environment variable? 


Is the environment variable GCC_EXEC_PREFIX defined to 
/ipa/products/FPMBase/1.0-0/bin ? 


Is the environment variable VX_CPU_FAMILY defined to 68K? 


If VxGDB is not invoked by the proper command or if it is not working correctly, check the 
following: 


Is FPMBase properly installed? 


Is the path to cross development tools /ipa/products/F PMBase/1.0-0/bin set up in the 
PATH environment variable? 


Is the environment variable GCC_EXEC_PREFIX defined to 
/ipa/products/F PMBase/1.0-O0/bin ? 


Is the softlink named vxWorks.st in the developer’s login directory created and pointing to 
the load module generated in /ipa/products/F PMBase/1.0-0/source? See Section 3.3.7 
Debugger Initialization for details. 
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The DB element PU535 represents the hardware. PU535 is called Free Programmable 
Module (FPM). PU535 contains a user-defined program which interfaces with an AMPL PC 


program. 


The main functions of the DB element PU535 are: 


° to indicate where in the subrack the hardware PU535 is placed 


° to pass error information from the PC program to System Status presented on the Operator 


Station 
FPM1 
Free prog. module 
( 340.1 ) 
— 1 — NAME WARNING ;-— 16— 
— 3 — BUS ERR }— 17 — 
— 4 — STATION ERRTYPE }+— 9 — 
—— 5 — POSITION 
—— 6 — SUBPOS 
—— 10 —y IMPL 
— PU535 — TYPE 


Figure A-1. Database element for PU535 
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TABLE OF PROPERTIES: 
Terminal Terminal Value entered Default value Data type Description 
no name by PC-conn 
1 NAME user FPMx - Unique name of the element 
3 BUS predef 0 - Not used 
4 STATION predef 0 - Not used 
5 POSITION user 0 - AC 410 : Always 1 which is the 
position of the processor 
module PM150. 
AC 450 : The position of the 
submodule carrier in 
the subrack, 1..14 
6 SUBPOSITION | user 0 - AC 410: The position of PU535 in 
PM150, 1..4 
AC 450 : The position of PU535 in 
the submodule carrier, 
1..2 
10 IMPL user 1 - Boolean which must be set to 1 if 
the PU535 submodule should be 
regarded as implemented. 
7 TYPE predef PU535 - Type of board 
16 WARNING PC 0 Br/w _ | Warning flag 
17 ERROR PC 0 Br/w _ {Error flag 
9 ERRTYPE PC 0 Br/w _ |Error flag 
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A.2 PC Elements 


FPM-COM: Command / Status Communication 


The PC element FPM-COM is used to control the FPM application via the dual port memory 
(DPM). For each PUS35, the PC element FPM-COM must be present in the corresponding 


AMPL program module. 
FPM-COM 
(C1) 

— 1—DBIDENT RUNNING|— 7—— 

—— 2— ENABLE ERROR;— 8—— 

— 3— RUN 

—— 4— STOP 

— 5— CONTINUE 

—— 11-4 INTERRUPT 1 

—— 194 INTERRUPT Cl 

Figure A-2. PC element FPM-COM 

SUMMARY: 


FPM-COM (Free Programmable Module COMmands) provides the functions below. 


° Holds the basic address of the board. Due to the fact that more than one PU535 can be 
installed in the Advant Controller, it is necessary to select each of them by a different 
address. 


° Sends execution commands to the FPM application module, written in C, installed on 
PUS35. 


° Presents the status information sent from the FPM application installed on PUS35. 


CALL: 
FPM-COM(C1) 


Parameter Significance Permitted value 


C1 Number of interrupt inputs /0 (not used by FPM) 
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CONNECTIONS: 


No 


Name 


Description 


DBIDENT 


Reference to a database element configuring 
the hardware containing PU535 


ENABLE 


Activation of FRM-COM. 

If set to 1 : control transfer occurs 

if set to 0 : the signal values are frozen and 
no control transfer occurs. 


RUN 


If set to 1, Start execution of the FPM 
application installed on PU535. If it changes to 
0, the current application program cycle stops 
after completion. A further change from 0 to 1 
initiates a new start after clearing all local data 
(including data stored in DPM). 


STOP 


Stops execution of the FPM application 
installed on PU535, after the end of the 
running cycle.Further activation is possible 
using the CONTINUE command. 


CONTINUE 


Continue execution of the FPM application at 
the beginning of the program, without clearing 
local data. 


RUNNING 


OB 


Set to 1, if FRM application installed on PU535 
is executing. The terminal is set to 0, if the FPM 
application is terminated via RUN(0), STOP(1) 
or if an error occurs. 
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No Name Type Description 


8 ERROR Ol This output terminal holds the corresponding 
error code for an FPM-COM terminal 
connection error or any runtime error of the 
FPM. 


Error Codes: 


1 : Address input not represented in 
hexadecimal form 


: Bus error 

: Not used 

: DPM not initialized 

: Execution error in FPM application 
: Address input not connected 

: Not Used 

: Incorrect board address 

9 : No FPM application installed on PU535 
10 : Input time-out on FPM occurred 
11 : Output time-out on FPM occurred 
12 : Not used 

13 : Data type error 


ON DO FW PD 


11 INTERRUPT IB At present these inputs are not used for FPM 
19 
FUNCTION: 


The FPM-COM element is used to control the execution of the FPM application installed on 
PUS535, as well as for retrieving status information. It transfers the commands START, STOP 
and CONTINUE to the dual port memory where it is read by the FPM application, installed on 
PUS35. 
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FPM-I : Data Input from FPM 


FPM-I 
(Cl,...,C8) 
—— 1 —DBIDENT 
—— 2 BLOCK ERROR} 6 
— 3 —ENABLE 


S11 |- 11 
$10 +C2|— 10+ C2 — 


s21 |. 21 

$20 +C4|- 20+ C4 — 
S31 |- 31 

$30 + C6|— 30 + C6 — 
S41 |— 41 


$40 + C8|K 40 + C8 — 


Figure A-3. PC element FPM-I 


SUMMARY: 


FPM-I reads data from dual port memory (DPM) and makes data available for other 
PC-elements, on its output terminals. The data is written to DPM using write routines in 
FPMLIib, by the FPM application installed on PUS35. 


CALL: 
FPM-I(C1,..,C8) 


Parameter Function Permitted values 
C1 Data type of section 1 signals B,ILIL,R,T,TR 
C2 Data size of section 1 0...5 
C3 Data type of section 2 signals B,ILIL,R,T,TR 
C4 Data size of section 2 0...5 
C5 Data type of section 3 signals B,ILIL,R,T,TR 
C6 Data size of section 3 0...5 
C7 Data type of section 4 signals B,ILIL,R,T,TR 
C8 Data size of section 4 0...5 
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CONNECTIONS: 
No Name Type Description 
1 DBIDENT IA Reference to a database element 
configuring the hardware containing 
PU535. 
2 BLOCK I Block number for data in DPM. 
Permitted values are 1...50. 
3 ENABLE IB If set to 1, the FPM-I element is activated. 
If set to 0, no action is performed. 
6 ERROR Ol If an error occurs, an error code is 
presented at this output terminal. 
Error Codes : 
1 : Address input not represented in 
hexadecimal form 
2 : Bus error 
3 : Not used by FPM-| 
4 : DPM not initialized 
5 : Not used by FPM-I 
6 : Address input not connected 
7 : Invalid block number 
8 : Incorrect board address 
11- $11 -$15 Input data of the data type in accordance 
15 with the parameter C1 
21- $21 - $25 Input data of the data type in accordance 
25 with the parameter C3 
31- $31 - S35 Input data of the data type in accordance 
35 with the parameter C5 
41- S41 - S45 Input data of the data type in accordance 
45 with the parameter C7 
FUNCTION: 


FPM-I reads data from DPM in accordance with the given block number. The data read is 
written in DPM by the FPM application installed on PU535 using write routines in FPMLib. 
Only when all the data specified by the FPM-I element is updated, the data is read. 


One FPM-I element is able to transfer a maximum of 20 signals, irrespective of the signal type. 
This amount of data is subdivided into 4 sections with 5 signals each. For each section, a 
different size and a different data type may be defined, by call parameters. 


Using up to 50 FPM-I functions, a total number of 1000 values can theoretically be read from 
the double port memory. However 50 is the total number of input and output elements for one 
PU535. Therefore the allowed number of input elements (NI) is equal to 50-NO, where NO is 
the total number of output elements. 
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FPM-O : Data Output to FPM 


FPM-O 

(Cl,...,C8) 
—— | —DBIDENT 
——— 2 — BLOCK ERROR |/- 6 
——— 3 — ENABLE 


u-) su 
— 10+C2 S10 +2 


21-) $21 

— 20+ C4 —]$20'+ C4 
31—] $31 

— 30+ C6 —]$30'+ C6 
41—| S41 


— 40+ C8 —|S40'+ C8 


Figure A-4. PC element FPM-O 


SUMMARY: 


FPM-O writes the values of its input terminals into the dual port memory (DPM), in accordance 
with the assigned block number. The application installed on PU535 reads the values with C- 
routines defined in FPMLib. 


CALL: 
FPM-O(Cl.,...,C8) 


Parameter Function Permitted values 
C1 Data type of section 1 signals B,ILIL,R,T,TR 
C2 Data size of section 1 0...5 
C3 Data type of section 2 signals B,ILIL,R,T,TR 
C4 Data size of section 2 0...5 
C5 Data type of section 3 signals B,ILIL,R,T,TR 
C6 Data size of section 3 0...5 
C7 Data type of section 4 signals B,ILIL,R,T,TR 
C8 Data size of section 4 0...5 
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CONNECTIONS: 
No Name Type Description 
1 DBIDENT IA Reference to a database element 
configuring the hardware containing 
PU535. 
2 BLOCK I Block number for data in DPM. 
Permitted values are 1...50. 
3 ENABLE IB If set to 1, the FPM-O element is activated. 
If set to 0, no action is performed. 
6 ERROR Ol If an error occurs, an error code is 
presented at this output terminal. 
Error Codes : 
1 : Address input not represented in 
hexadecimal form 
2 : Bus error 
3 : Not used by FPM-O 
4 : DPM not initialized 
5 : Not used by FPM-O 
6 : Address input not connected 
7 : Invalid block number 
8 : Incorrect board address 
11- $11 -$15 Output data of the data type in accordance 
15 with the parameter C1 
21- $21 - $25 Output data of the data type in accordance 
25 with the parameter C3 
31- $31 - S35 Output data of the data type in accordance 
35 with the parameter C5 
41- S41 - S45 Output data of the data type in accordance 
45 with the parameter C7 
FUNCTION: 


FPM-O reads data from its input terminals and writes them into DPM in accordance with the 
given block number. FPM-O also indicates for the FPM application, installed on PU535, when it 
is valid to read the data in DPM. The mentioned application reads the data, written in DPM by 
FPM-O, using read routines in FPMLib. 

One FPM-O element is able to transfer a maximum of 20 signals, irrespective of the signal-type. 
This amount of data is subdivided into 4 sections with 5 signals each. For each section, a 
different size and a different data type may be defined, by call parameters. 

Using up to 50 FPM-O elements, a total number of 1000 values can theoretically be written to 
the dual port memory (DPM). However 50 is the total number of input and output elements for 
one PU535. Therefore, the allowed number of output elements (NO) is equal to 50-NI, where NI 
is the total number of implemented input elements. 
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FPM-IA : Array Input from FPM 


FPM-IA 
(Cl) 
1 — DBIDENT 
2 — BLOCK ERROR; 6 
3 —| ENABLE 


DATA 11 


Figure A-5. PC element FPM-IA 


SUMMARY: 


FPM-IA reads ASCIl-array data from the dual port memory (DPM), and makes data available 
for other PC-elements on one of its output terminals. 
The data is written to DPM by the FPM application installed on PU535 using the write_A 


routine in FPMLib. 
CALL: 
FPM-IA(C1) 
Parameter Description Permitted values 
C1 Number of array elements 1...80 
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CONNECTIONS: 


No Name Type Description 


1 DBIDENT IA Reference to a database element 
configuring the hardware containing 
PU535. 


2 BLOCK Il Block number for data in DPM. 
Permitted values are 1...50. 


3 ENABLE IB If set to 1, the FPM-IA element is activated. 
If set to 0, no action is performed. 


6 ERROR Ol If an error occurs, an error code is 
presented at this output terminal. 


Error codes: 


1 : Address input not represented in 
hexadecimal form 

: Bus error 

: Not used by FPM-IA 

: DPM not initialized 

: Not used by FPM-IA 

: Address input not connected 

: Invalid block number 

: Incorrect board address 


CONDOR OW P 


11 DATA OA Output for array data 


FUNCTION: 


FPM-IA reads a data string from the dual port memory (DPM), in accordance with the given 
block number. The data string read is written in DPM by the application installed on PUS35 
using the write_A routine in FPMLib. If the length of the string in DPM is greater than C1, the 
transferred string array is shortened to Cl when read. The data string is only read if it has been 
updated since last time read. 


Using up to 50 FPM-IA elements, a total number of 50 data strings can theoretically be read 
from the dual port memory (DPM). However 50 is the total number of input and output 
elements for one PUS35. Therefore the allowed number of input elements (NJ), is equal to 50- 
NO, where NO is the total number of output elements. 
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FPM-OA : Array Output to FPM 


SUMMARY: 


FPM-OA 
(Cl) 
——— 1 —DBIDENT 
——— 2 —|BLOCK 
——— 3 —|ENABLE 


11—| DATA 


ERROR; 6 


Figure A-6. PC element FPM-OA 


FPM_OA writes the ASCII-array data, specified at the input terminal DATA, to the dual port 
memory (DPM). The FPM application installed on PU5S35 reads the string using the read_A 


routine in FPMLib. 
CALL: 
FPM-OA(C1) 
Parameter Description Permitted values 
C1 Number of array elements 1...80 
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CONNECTIONS: 


No Name Type Description 


1 DBIDENT IA Reference to a database element 
configuring the hardware containing 
PU535. 


2 BLOCK Il Block number for data in DPM. 
Permitted values are 1...50. 


3 ENABLE IB If set to 1, the FPM-OA element is 
activated. 
If set to 0, no action is performed. 


6 ERROR Ol If an error occurs, an error code is 
presented at this output terminal. 


Error codes: 


1 : Address input not represented in 
hexadecimal form 

: Bus error 

: Not used by FPM-OA 

: DPM not initialized 

: Not used by FPM-OA 

: Address input not connected 

: Invalid block number 

: Incorrect board address 


ONOaR WP 


11 DATA OA Output for array data 


FUNCTION: 


FPM-OA writes the input string, specified at its input terminal DATA, to the dual port memory 
(DPM) in accordance with the defined block number. The FPM application installed on PU535 
reads the data string from DPM using the read_A routine in FPMLib. 


Using up to 50 FPM-OA elements, a total number of 50 data strings can theoretically be written 
to the dual port memory (DPM). However 50 is the total number of input and output elements 
for one PU535. Therefore the allowed number of output elements (NO), is equal to 50-NI, 
where NI is the total number of input elements. 
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B.1 FPMLib 


read_B 


NAME: 
read_B - reads a boolean value from AMPL 


SYNOPSIS: 
FpmStatus read_B (Bool* value, int block, int section, int element) 
value /* The value read */ 
block /* Block number to read */ 
section /* Section in block to read */ 
element /* Element in section to read */ 
DESCRIPTION: 
The read_B function reads a boolean value from specified block, section and element in 
DPM. 
RETURNS: 


FpmOk if successful, otherwise FpmError 


read_I 


NAME: 
read_I - reads an integer value, consisting of 2 bytes, from AMPL 


SYNOPSIS: 
FpmStatus read_I (int_16* value, int block, int section, int element) 
value /* The value read */ 
block /* Block number to read */ 
section /* Section in block to read */ 
element /* Element in section to read */ 
DESCRIPTION: 


The read_I function reads an integer value consisting of 2 bytes from specified 
block, section and element in DPM. 


RETURNS: 
FpmOk if successful, otherwise FpmError 
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read_IL 


NAME: 
read_IL - reads an integer value, consisting of 4 bytes, from AMPL 


SYNOPSIS: 
FpmStatus read_IL(int_32* value, int block, int section, int element) 
value /* The value read */ 
block /* Block number to read */ 
section /* Section in block to read */ 
element /* Element in section to read */ 
DESCRIPTION: 


The read_IL function reads an integer value consisting of 4 bytes from specified 
block, section and element in DPM. 


RETURNS: 
FpmOk if successful, otherwise FpmError 


read_R 


NAME: 
read_R - reads a real value from AMPL 


SYNOPSIS: 
FpmStatus read_R (float* value, int block, int section, int element) 
value /* The value read */ 
block /* Block number to read */ 
section /* Section in block to read */ 
element /* Element in section to read */ 
DESCRIPTION: 
The read_R function reads a real value from specified block, section and element in 
DPM. 
RETURNS: 


FpmOk if successful, otherwise FpmError 
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read_T 


NAME: 
read_T - reads a time value, consisting of 4 bytes, from AMPL 


SYNOPSIS: 
FpmStatus read_T (int_32* value, int block, int section, int element) 
value /* The value read */ 
block /* Block number to read */ 
section /* Section in block to read */ 
element /* Element in section to read */ 
DESCRIPTION: 


The read_T function reads a time value consisting of 4 bytes from specified 
block, section and element in DPM. 


RETURNS: 
FpmOk if successful, otherwise FpmError 


read_TR 


NAME: 
read_TR - reads a time real value from AMPL 


SYNOPSIS: 
FpmStatus read_TR (float* value, int block, int section, int element) 
value /* The value read */ 
block /* Block number to read */ 
section /* Section in block to read */ 
element /* Element in section to read */ 
DESCRIPTION: 
The read_TR function reads a time real value from specified block, section and element 
in DPM. 
RETURNS: 


FpmOk if successful, otherwise FpmError 


B-3 


Free-Programmable Module 


Appendix B Runtime Library 


B-4 


read_A 


NAME: 
read_A - reads a string from AMPL 


SYNOPSIS: 

FpmStatus read_A(char* value, int block) 

value /* The read string*/ 

block /* Block number to read */ 
DESCRIPTION: 

The read_A function reads a string from specified block in DPM. 
RETURNS: 


FpmOk if successful, otherwise FpmError 


write_B 
NAME: 
write_B - writes a boolean value to AMPL 
SYNOPSIS: 
FpmStatus write_B (Bool* value, int block, int section, int element) 
value /* The value to write*/ 
block /* Block number to write*/ 
section /* Section in block to write*/ 
element /* Element in section to write*/ 
DESCRIPTION: 
The write_B function writes a boolean value to specified block, section and element in 
DPM. 
RETURNS: 


FpmOk if successful, otherwise FpmError 
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write_I 
NAME: 
write_I - writes an integer value consisting of 2 bytes , to AMPL 
SYNOPSIS: 
FpmStatus write_I (int_16* value, int block, int section, int element) 
value /* The value to write*/ 
block /* Block number to write*/ 
section /* Section in block to write*/ 
element /* Element in section to write*/ 
DESCRIPTION: 


The write_I function writes an integer value consistingt of 2 bytes to specified 
block, section and element in DPM. 


RETURNS: 
FpmOk if successful, otherwise FpmError 


write_IL 
NAME: 
write_IL - writes an integer value consisting of 4 bytes , to AMPL 
SYNOPSIS: 
FpmStatus write_IL (int_32* value, int block, int section, int element) 
value /* The value to write*/ 
block /* Block number to write*/ 
section /* Section in block to write*/ 
element /* Element in section to write*/ 
DESCRIPTION: 


The write_IL function writes an integer value consistingt of 4 bytes to specified 
block, section and element in DPM. 


RETURNS: 
FpmOk if successful, otherwise FpmError 
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write_R 
NAME: 
write_R - writes a real value to AMPL 
SYNOPSIS: 
FpmStatus write_R (float* value, int block, int section, int element) 
value /* The value to write*/ 
block /* Block number to write*/ 
section /* Section in block to write*/ 
element /* Element in section to write*/ 
DESCRIPTION: 
The write_R function writes a real value to specified block, section and element in 
DPM. 
RETURNS: 
FpmOk if successful, otherwise FpmError 
write_T 
NAME: 
write_T - writes a time value consisting of 4 bytes, to AMPL 
SYNOPSIS: 
FpmStatus write_T (int_32* value, int block, int section, int element) 
value /* The value to write*/ 
block /* Block number to write*/ 
section /* Section in block to write*/ 
element /* Element in section to write*/ 
DESCRIPTION: 


The write_T function writes a time value consisting of 4 bytes to specified block, section 
and element in DPM. 


RETURNS: 
FpmOk if successful, otherwise FpmError 
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write_TR 
NAME: 
write_TR - writes a time real value to AMPL 
SYNOPSIS: 
FpmStatus write_TR (float* value, int block, int section, int element) 
value /* The value to write*/ 
block /* Block number to write*/ 
section /* Section in block to write*/ 
element /* Element in section to write*/ 
DESCRIPTION: 


The write_TR function writes a time real value to specified block, section and 
element in DPM. 


RETURNS: 
FpmOk if successful, otherwise FpmError 


write_A 
NAME: 
write_A - writes a string to AMPL 
SYNOPSIS: 
FpmStatus write_A (char* value, int block ) 
value /* The string to write*/ 
block /* Block number to write*/ 
DESCRIPTION: 


The write_A function writes a string to specified block in DPM. 


RETURNS: 
FpmOk if successful, otherwise FpmError 
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Appendix C Hardware Module 


C.1 PU535 Communication Interface 


° Two RS-232-C communication interfaces 


° Modem support. 


Description 


PU535 Free Programmable module is a submodule which is to be mounted in the submodule carriers SC510, SC520 and SC530 
in Advant Controller 450 and Processor Module PM150 in Advant Controller 410. There are two RS-232-C communication 
interfaces, channel 1 and channel 2. Channel | is used for console communication and channel 2 is used for connection of an HP 
9000/700 series work station, using the SLIP protocol. 


The communication channels support communication speeds up to 19.2 kbit/s, which is the limit set by the system software. 
Both channels can run at this speed simultaneously. 


The maximum communication distance without modems is 15 m. The modem signals which are supported can be found in 
Table C-1 below. Note that the communication pins are short-circuit proof. 


FLASH PROMs $0-$7FFFF 
EVEN ODD 
PU 
535 |ABB 
FA | RUN-LED 1 
0.0 4 si 
— 12 
So) FAULT-LED 2 34 4 
CHANNEL 1 
(X4) 
X4 
E 
| 
1) 
CHANNEL 2 
| (X35) 
X5 
| 2 | 1 2 
cia 
Front View 


Figure C-1, PU535 Submodule 
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Technical Data 


Indicators 


There are two indicators on the submodule front: 


LED R, Run (green). Indicates that the module is running normally. 


LED F, Fault (red). Indicates a fatal error detected on the PU535 module. The LED is also turned on at reset of the module. 


Jumpers 


The board contains one jumper for special purposes. In normal operation always keep the S1 in position 3 - 4 (‘parking place’). 
The component and position indications are found on the printed circuit board. 


Connectors 


Serial channels 1 and 2 connectors (X4 and X5): 


¢ Connector type: Nine-pole male DSUB (DE9P) 


¢ Placement: On module front 


¢ Pin designation: See Table C-1 below. 


C-2 


Table C-1. Pin Designation for Channels 1 and 2 on PU535 submodule. 


Pin Short Description 
1 DCD Data Carrier Detect 
2 RD Receive Data 
3 TD Transmit Data 
4 DTR Data Terminal Ready 
5 GND Ground 
6 DSR Data Set Ready 
7 RTS Request To Send 
8 CTS Clear To Send 
9 Ri Ring Indicator 
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Power Supply 

SV typical 400 mA 
max. 670 mA 

24V max. 40 mA 

Power loss (heat) typical 3 W 


Mechanical Data 
Module size: The module occupies one submodule slot (H = 95 mm, L = 140 mm, connectors not included). 


Weight: 0.13 kg 


C.2 CI536 Communication Interface 


° Two RS-232-C communication interfaces 


° Modem support. 


Description 


CI536 is a submodule used for development and debugging purposes. It is to be mounted in one of the submodule carriers 
SC510, SC520 and SC530 in Advant Controller 450 and Processor Module PM150 in Advant Controller 410. There are two RS- 
232-C communication interfaces, channel | and channel 2. Channel 1 is used for console communication and channel 2 is used 
for connection of an HP 9000/700 series work station, using the SLIP protocol. 


The communication channels support communication speeds up to 19.2 kbit/s, which is the limit set by the system software. 
Both channels can run at this speed simultaneously. 


The maximum communication distance without modems is 15 m. The modem signals which are supported can be found in 
Table C-2. 


Communication pins are short-circuit proof. 
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Flash PROMs $80000-FFFFF $0-7FFFF 
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Figure C-2. CI536 Submodule 


Technical Data 


Indicators 


There are two indicators on the submodule front: 


LED R, Run (green). Indicates that the module is running normally. 


LED F, Fault (red). Indicates a fatal error detected on the PU535 module. The LED is also turned on at reset of the module. 


Jumpers 


The board contains one jumper for special purposes. In normal operation always keep the S1 in position 3 - 4 (‘parking place’). 
The component and position indications are found on the printed circuit board. 


Connectors 
Serial channels 1 and 2 connectors (X4 and X5): 
¢ Connector type: Nine-pole male DSUB (DE9P) 


e Placement: On module front 
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Table C-2. Pin Designation for Channels I and 2 on CI536 submodule. 


Pin Short Description 
1 DCD Data Carrier Detect 
2 RD Receive Data 
3 TD Transmit Data 
4 DTR Data Terminal Ready 
5 GND Ground 
6 DSR Data Set Ready 
7 RTS Request To Send 
8 CTS Clear To Send 
9 Ri Ring Indicator 
Power Supply 
SV typical 400 mA 
max. 670 mA 
24V max. 40 mA 
Power loss (heat) typical 3 W 


Mechanical Data 


Module size: The module occupies one submodule slot (H = 95 mm, L = 140 mm, connectors not included). 


Weight: 0.13 kg 
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